IAB Categorization

    This feature is only enabled for Enterprise accounts! If you are not sure if your account is enabled for Enterprise features, please contact your account manager.

    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"
                }
            ]
        },
        ...
    }