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.
Updated about 1 month ago