Append IAB tags 🏷️

This is a guide for using our IAB Tags endpoint `content/recommend/iab_category` .This endpoint allows you to retrieve a list of IAB (Interactive Advertising Bureau) tags, which are used to categorize digital content and adverts based on industry-standard classifications. These tags can be leveraged in advertising and content management systems for more precise content targeting and compliance. We are currently using v.3 of the IAB categorization taxonomy.


What are IAB Tags❓

IAB tags are a standardized set of categories designed by the IAB (Β Interactive Advertising BureauΒ ) to classify online content, making it easier for advertisers and publishers to match content with appropriate ads. These tags are organized hierarchically, starting with broad categories that branch into more specific subcategories.

For example:

  • IAB1: Arts & Entertainment
    • IAB1-1: Books & Literature
    • IAB1-2: Celebrity Fan/Gossip

By using the endpoint, you can retrieve these categories and subcategories to label your content within AudioStack appropriately.

The IAB Tags API endpoint is available via a simple POST request. No complex setup is required; just make the request and get the data you need. Our API docs are also here.

  • Method: POST
  • URL: "https://v2.api.audio/content/recommend/iab_category"

Example Request

import requests

url = "https://v2.api.audio/content/recommend/iab_category"

payload = {
  "text": "AudioStack's technology seamlessly integrates into your product or workflow and cuts your audio production cycles to seconds while making your budgets go further.",
  "num_tags": 3,
  "language": "en"
}

headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "x-api-key": "your-api-key"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Example Response

{β€œdata”: {β€œtags”: [{β€œcategory”: β€œiab”, β€œtag”: β€œAudio Production”, β€œtier1”: β€œHobbies & Interests”, β€œtier2”: β€œContent Production”, β€œtier3”: β€œAudio Production”, β€œsimpleTag”: β€œArts, Media & Sports”}, 

{β€œcategory”: β€œiab”, β€œtag”: β€œDigital Audio”, β€œtier1”: β€œTechnology & Computing”, β€œtier2”: β€œComputing”, β€œtier3”: β€œComputer Software and Applications”, β€œsimpleTag”: β€œTechnology”}, 

{β€œcategory”: β€œiab”, β€œtag”: β€œSoftware and Applications”, β€œtier1”: β€œTechnology & Computing”, β€œtier2”: β€œComputing”, β€œtier3”: β€œComputer Software and Applications”, β€œsimpleTag”: β€œTechnology”}]}, 

β€œmeta”: {β€œversion”: β€œβ€, β€œrequestId”: β€œ98dfe650-35ee-4357-aba7-464ff6b6d15d”, β€œcreditsUsed”: 5, β€œcreditsRemaining”: 999659.873}, β€œmessage”: β€œCategorization Successful”, β€œwarnings”: []}


Key fields πŸ”‘

β€˜β€™tag’’: leaf value, ie the most specific one from the IAB categories ( β€˜β€™SUV’’)

β€˜β€™tier1’’: previous level of specificity (’’Auto Parts”)

β€˜β€™tier2’’: previous level of specificity from tier 1 (”automotive’’)

β€˜β€™tier3’’: broadest categorisation (’’cars’’)

β€˜β€™simpleTag’’: this is our internal AudioStack taxonomy created by our experts to assist with categorization of your assets.

You will also get the metadata associated with the API call (β€œversion”: β€œβ€, β€œrequestId”: β€œ98dfe650-35ee-4357-aba7-464ff6b6d15d”, β€œcreditsUsed”: 5, β€œcreditsRemaining”: 999659.873}, β€œmessage”: β€œCategorization Successful”, β€œwarnings”: []} ) and you will also be notified if a warning comes up. The cost of this service is 5 production credits per tagged asset.