IAB Category Classifier — predict Tier 1 labels

IAB Tier 1 Content Classification API

What it does

IAB Category Classifier predicts Tier 1 IAB categories for web content. Send a URL, text, title, domain, or keywords, and get back a tier label plus a ranked list of category predictions with scores.

Use it when you need to classify articles, landing pages, or publisher inventory into a standard advertising taxonomy. The top_k field lets you control how many predictions you want returned, from 1 to 20, so you can keep the output focused on the best matches or inspect a broader set of candidates.

The response is simple to integrate: tier tells you the tier being predicted, and predictions is an array of { label, score } objects. That makes it easy to route content, power ad targeting rules, organise analytics, or add taxonomy labels during ingestion without building your own classifier.

IAB Category Classifier is a good fit for content pipelines that need fast, repeatable category assignment from lightweight metadata or full page text.

Quickstart

Classify a piece of content into an IAB tier 1 prediction using the required text, URL, or related metadata fields.

curl -X POST "http://localhost:8080/dosvak/classify-iab-tier-1" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Latest football match highlights and league analysis"}'

About this endpoint

What it does

Predicts IAB Tier 1 categories for the supplied content signals and returns the predicted tier plus a list of category predictions.

Request Body

Parameter	Type	Mandatory	Description
url	String	No	A URL to classify. Nullable.
text	String	No	Text content to classify. Nullable.
title	String	No	Title text to classify. Nullable.
top_k	Integer	No	Maximum number of predictions to return. Default: 3. Minimum: 1. Maximum: 20.
domain	String	No	Domain to help classify the content. Nullable.
keywords	String	No	Keywords to help classify the content. Nullable.

Response

Returns a JSON object with a tier string field and a predictions array field. Each item in predictions is an object with label and score fields.

Parameter	Type	Mandatory	Description
tier	String	No	Predicted IAB tier identifier returned by the service.
predictions	Object Array	No	Array of prediction objects. Each object contains `label` and `score` fields.
predictions[].label	String	No	Predicted category label.
predictions[].score	Number	No	Prediction score for the label.

Body

Name

Type

Description

bodyREQUIRED

object

—

IAB Tier 1 Content Classification API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return