IAB Category Classifier — predict Tier 2 labels

IAB Tier 2 Content Classification API

What it does

IAB Category Classifier predicts IAB Tier 2 topic labels from a URL, page text, title, domain, or keywords. Send one or more of those inputs, and you get a ranked list of category predictions back.

Use the top_k field to control how many predictions you receive, from 1 to 20. The response includes the detected tier and a predictions array, where each prediction contains a label and a score. That makes it straightforward to route content into ad categories, segment articles, or attach taxonomy labels in a CMS or analytics pipeline.

This is a good fit when you need to classify web pages, editorial content, or marketing copy into a standard ad taxonomy without hand-tagging every item. For example, you can score inbound URLs before storing them, or classify text snippets as part of a content moderation or campaign workflow.

The service accepts nullable url, text, title, domain, and keywords fields, so you can send whatever context you have and let the model predict from it.

Quickstart

Classify text, a URL, or both into IAB Tier 2 categories with the default top-k result count.

curl -X POST "http://localhost:8080/dosvak/classify-iab-tier-2" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Latest updates on electric vehicles and battery technology",
    "top_k": 3
  }'

What you'll get back

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

{
  "tier": "IAB Tier 2",
  "predictions": [
    { "label": "Electric Vehicles", "score": 0.98 },
    { "label": "Battery Technology", "score": 0.91 }
  ]
}

About this endpoint

What it does

Predicts IAB Tier 2 categories for the provided content signals and returns a JSON object containing the predicted tier plus a ranked list of category predictions.

Request Body

Parameter	Type	Mandatory	Description
url	String	No	URL to classify.
text	String	No	Text content to classify.
title	String	No	Title or headline to classify with the content.
top_k	Integer	No	Number of predictions to return. Default: 3. Minimum: 1. Maximum: 20.
domain	String	No	Domain associated with the content.
keywords	String	No	Keywords associated with the content.

Response

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

Attribute	Type	Mandatory	Description
tier	String	No	Predicted IAB tier 2 category tier.
predictions	Object Array	No	List of prediction objects. Each item contains `label` and `score`.
predictions[].label	String	No	Predicted category label.
predictions[].score	Number	No	Prediction confidence score.

Body

Name

Type

Description

bodyREQUIRED

object

—

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return