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.