IAB Categorization

Using the IAB Classification feature, AssemblyAI can classify your transcription text with up to 5 out of 370 possible content categories. The top level categories are:

Automotive 
Books and Literature 
Business and Finance 
Careers 
Education 
Events and Attractions 
Family and Relationships 
Fine Art 
Food and Drink 
Healthy Living 
Hobbies and Interests 
Home and Garden 
Medical Health 
Movies 
Music and Audio 
News and Politics 
Personal Finance 
Pets 
Pop Culture 
Real Estate 
Religion and Spirituality 
Science 
Shopping 
Sports 
Style and Fashion 
Technology and Computing 
Television 
Travel 
Video Gaming 

Enabling IAB Categorization when submitting files for transcription

Simply include the iab_categories parameter in your POST request, and set this parameter to true, as shown in the cURL request below.

curl --request POST \
  --url https://api.assemblyai.com/v2/transcript \
  --header 'authorization: YOUR-API-TOKEN' \
  --header 'content-type: application/json' \
  --data '{"audio_url": "https://app.assemblyai.com/static/media/phone_demo_clip_1.wav", "iab_categories": true}'

Getting IAB Categories in the response

Once the transcription is complete, and you make a GET request to /v2/transcript/<id> to receive the transcription, there will be an additional key iab_categories_result:

{
    # some keys have been hidden for readability
    ...
    "audio_duration": 12.0960090702948,
    "audio_url": "https://s3-us-west-2.amazonaws.com/blog.assemblyai.com/audio/8-7-2018-post/7510.mp3",
    "confidence": 0.956,
    "format_text": true,
    "id": "5551722-f677-48a6-9287-39c0aafd9ac1",
    "status": "completed",
    "text": "...",
    "iab_categories_result": {
        "status": "success", 
        "results": [
            {
                "relevance": 1.0, 
                "label": "NewsAndPolitics>Politics"
            }, 
            {
                "relevance": 0.4, 
                "label": "NewsAndPolitics>Law"
            }
        ]
    },
    ...
}