APITube Help Center

Categories, Topics and Industries: What Is the Difference

Choose category, topic, or industry filters for your search

Tasha Tatum

Written by Tasha Tatum

July 6, 2026

Updated October 16, 2026

Categories, topics and industries: what is the difference

Categories describe a broad news subject, topics identify recurring themes, and industries identify business sectors. Each appears in an article response and has its own filter: category.id, topic.id, or industry.id.

Category IDs look like medtop:04000000, topic IDs like industry.automotive_news, and industry IDs are numbers.

What are categories (IPTC Media Topics)?

Categories use the news classification maintained by the IPTC. APITube lists 1,085 categories, with IDs made of medtop: and eight digits. For example, medtop:04000000 means economy, business, and finance.

Broad categories contain narrower ones. See the full category tree.

category.id matches only the exact IDs you provide. It does not include child categories automatically. You can pass up to three comma-separated IDs. See how to filter news by category.

What are topics?

Topics describe more specific subjects, such as automotive news or crude oil. APITube lists 69 topic IDs: 26 starting with industry.* and 43 with market_news.*.

Use the full text ID with topic.id, such as industry.automotive_news or market_news.commodities.crude_oil. See the list of topics and how to filter news by topic.

What are industries?

Industries identify the business sector an article concerns. The list has 1,264 sectors, starting at 0 for Aerospace Defense.

Use a numeric ID, such as industry.id=88. See the industry list for names and descriptions, and how to filter news by industry for examples.

How do the three appear in an API response?

Each is an array of objects:

  • categories[]: id, name, taxonomy, links.self, and score.
  • topics[]: id, name, links.self, and score.
  • industries[]: id, name, and links.self, without a score.

The category taxonomy is normally iptc_mediatopics.

Filters accept IDs rather than names, with up to three values per parameter. To exclude values, use ignore.category.id, ignore.topic.id, or ignore.industry.id. Unknown IDs return 400.

Common Questions

Can I filter by category or topic name instead of ID?

No. Look up the name in the reference lists or use autocomplete with the Suggest API, then send its ID.

Which of the three should I use for monitoring?

Use categories for subjects such as sports or politics, topics for specific themes such as crude oil, and industries for business sectors. You can combine them; for example, select a crude-oil topic within a business category.

Do I have to memorise the ID lists?

No. Use the reference lists or Suggest endpoints to find the IDs you need, then save those values in your integration.


Related Articles