<!-- The markdown copy of https://oppalerts.com/docs/the-data/taxonomies . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [The Data](https://oppalerts.com/docs/the-data/) / Taxonomies

# Taxonomies

Compare your writing with standard category lists used by advertisers, publishers, and search engines.

## What a taxonomy is

A taxonomy is a fixed list of categories, for example "Travel > Hotels". OppAlerts includes 11 standard taxonomies. It compares writing with every category in each taxonomy using semantic similarity.

## The 11 taxonomies

- `google-ads-topics`: Google Ads topics, 2,558 categories.
- `google-merchant`: Google Merchant product categories, 5,595 categories.
- `iab-ad-product-taxonomy`: IAB ad product taxonomy, 583 categories.
- `iab-audience-taxonomy`: IAB audience taxonomy, 1,558 categories.
- `iab-content-taxonomy`: IAB content taxonomy, 704 categories.
- `iptc-media-topics`: IPTC media topics, 1,084 categories.
- `linkedin-industry-codes`: LinkedIn industry codes, 424 categories.
- `microsoft-advertising`: Microsoft Advertising categories, 5,427 categories.
- `census-naics`: the US Census NAICS industries, 2,125 categories.
- `soc`: the SOC occupations, 1,447 categories.
- `us-cities`: US cities, 4,117 categories.

## How the comparison works

- Your text is converted into a vector using the same model used for every category.
- OppAlerts compares the vector with every category and returns the nearest ones, with a similarity score.
- A strong match is usually in the 40s and 50s. Nothing reaches 90. Focus on the order and the gaps between results rather than the score alone.
- The score measures semantic similarity, not writing quality or keyword density.

## Where you use them

- [Content Optimizer](https://oppalerts.com/docs/app/content/optimizer): paste up to 8,192 bytes of writing, and pick up to three categories, one for each taxonomy. Each category is scored separately; the scores are never merged.
- A campaign's taxonomy presets, set on the Settings tab of Edit Campaign, populate the Content Optimizer for everyone on the account.
- MCP and the API: [`taxonomy_taxonomies`](https://oppalerts.com/docs/mcp/taxonomy_taxonomies) lists the taxonomies, [`taxonomy_categories`](https://oppalerts.com/docs/mcp/taxonomy_categories) lists the categories of one taxonomy, and [`taxonomy_semantic_content_analyzer`](https://oppalerts.com/docs/mcp/taxonomy_semantic_content_analyzer) returns Content Optimizer results for text and 1 to 3 target categories. The Content Optimizer page uses these 3 tools.

## Which taxonomy to use

- A product page: Google Merchant.
- An article: IAB Content or IPTC Media Topics.
- A page for one type of reader: IAB Audience or SOC occupations.
- A business or service page: NAICS or LinkedIn industry codes.
- A local service page: US cities. See [How to Optimize Local Service Content](https://oppalerts.com/docs/how-to/optimize-local-service-content).

## Related Pages

- [Content Optimizer](https://oppalerts.com/docs/app/content/optimizer) How to use the Content Optimizer page of the OppAlerts web app.
- [taxonomy_semantic_content_analyzer](https://oppalerts.com/docs/mcp/taxonomy_semantic_content_analyzer) How near a piece of writing is to the taxonomy categories you aim at, and the phrases that would move it nearer.
- [taxonomy_categories](https://oppalerts.com/docs/mcp/taxonomy_categories) The categories of one taxonomy: the id, the name, and the depth of each category, sorted by name.
- [taxonomy_taxonomies](https://oppalerts.com/docs/mcp/taxonomy_taxonomies) The taxonomies of the category tools: the name of each one, which the taxonomy field of taxonomy_categories takes, and how many categories it holds.
- [How to Check Draft Topic Relevance](https://oppalerts.com/docs/how-to/check-draft-topic-relevance) Know before you publish whether a draft covers the topic in its brief.
- [How to Optimize Local Service Content](https://oppalerts.com/docs/how-to/optimize-local-service-content) Make each local service page match the city it is written for.
