IAB Category Classifier — classify content by tier

IAB Tier 3 Content Classification API

What it does

IAB Category Classifier predicts IAB Tier 3 categories from a URL, page text, title, domain, or keywords. Send one or more of those signals along with an optional top_k value, and it returns the detected tier plus a ranked predictions array with each label and score.

Use it when you need to map articles, landing pages, or feed items into an IAB taxonomy for ad targeting, content routing, or reporting. If you only have a headline and a short snippet, you can classify that too; if you have the full page text or URL, the classifier can use that context as well.

The response is compact and easy to consume: tier tells you which IAB level was predicted, and predictions gives you the most likely category labels in descending order. Set top_k from 1 to 20 to control how many matches you receive.

IAB Category Classifier fits workflows that need consistent content tagging without maintaining a custom taxonomy lookup table. It is designed for batch enrichment and real-time classification alike.

Quickstart

Classify some text or a URL into IAB Tier 3 categories using the minimum required JSON body.

curl -X POST "http://localhost:8080/dosvak/classify-iab-tier-3" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"A new smartwatch with fitness tracking features","top_k":3}'

About this endpoint

What it does

Predicts IAB Tier 3 categories from the input content signals you provide. It accepts a body with optional source fields such as url, text, title, domain, and keywords, and returns a JSON object containing a tier string and a predictions array.

Request Body

Parameter	Type	Mandatory	Description
url	String	No	Source URL to classify. Nullable.
text	String	No	Input text to classify. Nullable.
title	String	No	Title associated with the content. Nullable.
top_k	Integer	No	Number of predictions to return. Default: 3. Minimum: 1. Maximum: 20.
domain	String	No	Domain associated with the content. Nullable.
keywords	String	No	Keywords associated with 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 containing a label string and a score number.

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

Body

Name

Type

Description

bodyREQUIRED

object

—

IAB Tier 3 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