A field guide to content intelligence

Make sense.Build withtopics.

Practical guides to topic APIs, structured AI output, and editorial taxonomies. Give unstructured content a vocabulary your application can understand.

For developers, publishers, and curious builders.

12connected topic guides
10in-depth Lab articles

Start with a clearer vocabulary.
Build a more useful content experience.

AI & LLMSNEWS & PUBLISHINGFINANCE & PREDICTIONCOUNTRIES & CONTEXT

01 / Explore the topic atlas

One connected world.
Many ways to organize it.

Start with the fundamentals, then find the vocabulary, fields, and review decisions that fit your domain.

Start with Topics API
START HERE01

Topics API

Stable IDs, useful JSON, and a vocabulary built to evolve.

AI & LANGUAGE02

AI Topics API

Label content with evidence, representative tests, and review.

PUBLISHING & CONTEXT03

News Topics API

Connect stories to subjects without losing the event context.

AI & LANGUAGE04

LLM Topics API

Turn language into structured, validated topic records.

AI & LANGUAGE05

Prompts Topics API

Write clear instructions for consistent topic assignments.

AI & LANGUAGE06

AI Model Topics API

Organize model tasks, versions, and capability evidence.

APPLIED DOMAINS07

Prediction Topics API

Keep subjects, horizons, and uncertainty in the record.

APPLIED DOMAINS08

Finance Topics API

Separate financial subjects from entities and reporting periods.

AI & LANGUAGE09

AGI Topics API

Map research concepts and keep capability claims in scope.

PUBLISHING & CONTEXT10

Country Topics API

Preserve place roles, local language, and geographic context.

PUBLISHING & CONTEXT11

Social Media Topics API

Understand sampling, repetition, and the limits of a trend.

PUBLISHING & CONTEXT12

Political Topics API

Classify policy subjects with attribution and context.

02 / A little structure goes a long way

Same content.
Clearer context.

A topic record connects a document to a defined concept. Explore three illustrative examples, then see how to design the contract behind them.

  1. 01
    Define the subject

    Give the vocabulary clear boundaries and stable identifiers.

  2. 02
    Keep the evidence

    Make it possible to inspect why a label fits the content.

  3. 03
    Make room for review

    Represent uncertainty before a label reaches a reader.

Design your topic contract
EXAMPLE RECORD
SOURCE TEXT / ILLUSTRATIVE

A publisher evaluates an LLM for its article archive.

{
  "topics": [
    {
      "id": "ai.language-models",
      "label": "Language models"
    },
    {
      "id": "publishing.archives",
      "label": "Digital archives"
    }
  ],
  "taxonomy_version": "demo-v1",
  "review_status": "needs_review"
}

Illustrative data for learning topic design. No live request is made.

03 / Find your reading path

Built around your next question.

FOR DEVELOPERS

What should the API return?

Work through identifiers, schema validation, topic assignment, and predictable handling of unknown content.

Explore structured topic output

FOR PUBLISHERS

How will readers find the story?

Build subject archives with useful editorial boundaries, source context, and a clear place for corrections.

Explore news taxonomies

FOR RESEARCHERS

What does the evidence support?

Keep model claims, uncertainty, sampling limits, and evaluation conditions attached to the concepts you organize.

Explore model context

04 / Ideas from the Lab

Go deeper.
Build with understanding.

Ten practical reads on the decisions behind useful topic systems. From the first JSON contract to the context that a label can miss.

Explore Topics API Lab

05 / Good questions

A few things
worth clarifying.

The vocabulary is only useful when everyone understands what it means.

Read the foundations
What is a topic API?

A topic API represents subjects and their relationship to content through a defined data contract. Depending on the design, it can expose a vocabulary, record topic assignments, or help an application retrieve documents by subject.

What can I find on TopicsAPI.com?

Twelve topic guides and ten long-form Lab articles covering API design, AI classification, news taxonomies, prompts, model metadata, and domain-specific context. Start with the Topics API foundations to choose a reading path.

Is this Google’s browser Topics API?

TopicsAPI.com is an independent resource focused on content classification and topic-data design. Google’s browser advertising Topics API is a separate technology. See the distinction in our topic contract guide.

Do I need a language model to classify topics?

Not every workflow needs one. A carefully defined rule, a trained classifier, or an editorial process may suit the task. Compare approaches on representative documents and review the errors that matter to your readers.

Can a topic label prove a prediction or model claim?

A topic identifies the subject of content. Keep any prediction, capability claim, evaluation result, or political statement separately attributed, with the context needed to interpret it.

Where should I start?

Developers can begin with the JSON contract guide. Publishers can start with the news topic guide. For automated labeling, continue to AI classification and evaluation.

A good topic starts with a better question.

Have a taxonomy question or an idea for the Lab? Get in touch.

Talk topics with us