Categories: API v4

Every category the API returns is a node in the IAB Content Taxonomy v3.1, the industry-standard tree maintained by IAB Tech Lab. We do not invent categories and we do not mix taxonomies — a label is always a node in this one tree.

One taxonomy, 704 categories, four tiers

Tier Categories Example
Tier 1 37 Technology & Computing
Tier 2 323 Technology & Computing > Computing
Tier 3 275 … > Computing > Internet
Tier 4 69 … > Internet > Web Development
Total 704

The complete list is available as a downloadable CSV, webcat_iab_v3.1_categories.csv — one row per category with its identifier, its parent, and its full tier path. That file is the authoritative answer to "exactly which categories can we expect": nothing outside it is ever returned.

How deep a label goes is not a measure of how much the page supported. For allow/block policy, key on tier 1 (or tiers 1 and 2) and treat deeper tiers as descriptive detail.

The 37 tier-1 categories

Attractions                          Genres                   Politics
Automotive                           Healthy Living           Pop Culture
Books and Literature                 Hobbies & Interests      Real Estate
Business and Finance                 Holidays                 Religion & Spirituality
Careers                              Home & Garden            Science
Communication                        Law                      Sensitive Topics
Crime                                Medical Health           Shopping
Disasters                            Personal Celebrations    Sports
Education                              & Life Events          Style & Fashion
Entertainment                        Personal Finance         Technology & Computing
Events                               Pets                     Travel
Family and Relationships                                      Video Gaming
Fine Art                                                      War and Conflicts
Food & Drink

Five of these are terminal and have no children: Communication, Crime, Disasters, Law and War and Conflicts.

Sensitive Topics

For access-control and web-filtering use cases, the Sensitive Topics tier-1 branch is usually the one that matters. It has eleven tier-2 children:

Adult & Explicit Sexual Content
Arms & Ammunition
Crime & Harmful Acts to Individuals, Society & Human Right Violations
Death, Injury, or Military Conflict
Debated Sensitive Social Issues
Hate Speech and Acts of Aggression
Illegal Drugs, Tobacco, eCigarettes, Vaping, Alcohol
Obscenity and Profanity
Online Piracy
Spam or Harmful Content
Terrorism

Gambling is carried separately at Attractions > Casinos & Gambling, with illegal-gambling markers routed to Sensitive Topics > Spam or Harmful Content.

If you are writing blocking rules, do not filter on the Sensitive Topics subtree alone. The taxonomy scatters what a policy treats as one thing across several branches — gambling being the clearest case. The Policy pack exists precisely to collapse the tree into a filtering vocabulary; use it rather than reconstructing the mapping yourself.

How a category is expressed

A result carries one category, written more than one way. These are representations of the same node, not separate classifications:

Representation Field(s) Example
Human-readable path tier1, tier2, tier3, tier4 Technology & Computing › Computing
Canonical IAB id id / iab_id IAB-599
Full path string path Technology & Computing > Computing
OpenRTB / AdCOM ids openrtb.cat (opt-in) the same node in OpenRTB encoding, cattax: 9

Pick whichever your systems consume. They always agree; if they ever disagree, that is a bug and we want to hear about it.

Fetching the tree from the API

curl "https://website-categorization.whoisxmlapi.com/api/v4/taxonomy?apiKey=YOUR_API_KEY"

This call validates your API key but charges no credits — it is reference data.

{
  "version": "3.1",
  "total_categories": 704,
  "tiers": { "1": 37, "2": 323, "3": 275, "4": 69 },
  "categories": [
    {
      "id": "599",
      "iab_id": "IAB-599",
      "name": "Computing",
      "tier": 2,
      "parent_id": "596",
      "children": [
        {
          "id": "600",
          "iab_id": "IAB-600",
          "name": "Computer Networking",
          "tier": 3,
          "parent_id": "599",
          "children": []
        }
      ]
    }
  ]
}

Computing has nine children; the example shows the first and elides the other eight.

Field Description
id The raw IAB v3.1 identifier, for example 599.
iab_id The prefixed identifier, for example IAB-599. This is the value /categorize results carry.
name Category name.
tier Depth, 1 to 4.
parent_id Raw identifier of the direct parent; null for tier-1 roots.
children Direct children, nested recursively; empty for leaves.

The top-level categories list stays flat and contains all 704 nodes, so every subtree also appears nested under each of its ancestors. Join on iab_id when matching against /categorize results.

Caching. The default tree changes only on a major taxonomy version bump, so you may cache it client-side indefinitely. The policy-annotated tree (?pack=policy_v1) follows a different rule — see Policy pack.