Unified Classification — multi-tier label prediction

IAB Unified Content Classification API

What it does

Unified Classification predicts labels across one or more tiers from a URL, text, title, domain, or keywords. Send the content you want classified and get back scored label candidates for each requested tier.

Use Unified Classification when you need to route articles, sort product pages, organize support content, or apply a taxonomy consistently across a large dataset. You can ask for the top predictions overall with top_k, or narrow the request by passing specific tiers such as tier1 and tier2.

The response returns a tiers object. Each tier maps to an array of label objects, and each object includes a label and a numeric score. That makes it easy to rank results, choose the best match, or display multiple classification options in your own app.

This API is a fit for content tagging, category assignment, and automated triage where you need structured classification results from a single request.

Quickstart

Classify some text or a URL into one or more tiers with the minimum required JSON body.

curl -X POST "http://localhost:8080/dosvak/classify-unified" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "A new AI startup raised seed funding for its product launch.",
    "top_k": 3
  }'

About this endpoint

What it does

Predicts classifications across one or more tiers in a single POST request. You send one or more content signals in the request body, and the response returns tier-specific prediction lists.

Request Body

Parameter	Type	Mandatory	Description
url	String	No	A URL to classify. Nullable.
text	String	No	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.
tiers	String Array	No	Which tiers to predict, for example `['tier1', 'tier2']`. Nullable.

Response

Returns a JSON object with a tiers object field. tiers is a map whose values are arrays of prediction objects; each prediction object contains label and score fields, and may include additional properties.

Parameter	Type	Mandatory	Description
tiers	Object	No	A map of tier names to arrays of prediction objects. Each prediction object includes `label` as a string and `score` as a number. The schema allows additional properties.

Body

Name

Type

Description

bodyREQUIRED

any

—

IAB Unified 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