Industries to Categories Migration Guide

We are adding over 550 new industries and fine-tuning existing industries to make querying companies more useful. You can access these new industries with categories field.

The legacy industries taxonomy will be deprecated on Friday, September 30, 2024.

This revamp requires updating of application DQL queries and schemas to account for breaking changes. Follow the steps below to fully migrate your application to categories.

Migrate DQL Queries

Update all DQL queries using the industries or diffbotClassification field to use the categories field instead.

Before:

• type:Organization industries:"Software Companies" or
• type:Organization diffbotClassification:"Software Companies"

After:

• type:Organization categories:"Software Companies"

Migrate JSON Schema

Applications that currently use the industries field and expects a list of strings need to be updated to accept a list of dictionaries/objects.

Before:

{
    "industries": [
        "Software Companies"
    ]
}

OR

{
    "diffbotClassification": [
        {
            "level": 1,
            "isPrimary": true,
            "name": "Software Companies"
        }
    ]
}

After:

{
    "categories": [
        {
            "types": [
                "Intangible",
                "OrganizationCategory"
            ],
            "level": 2,
            "isPrimary": true,
            "name": "Software Companies",
            "diffbotUri": "http://diffbot.com/entity/EIQlGD6L7P-OqerHtqaFBcw",
            "targetDiffbotId": "EIQlGD6L7P-OqerHtqaFBcw",
            "type": "OrganizationCategory"
        }
    ]
}

Migrate Industry Names to Category Names

Applications using querying specific industry names with DQL or expecting specific industry names with Enhance will need to be updated.

The following table outlines all removed, specialized, and renamed industries and their categories equivalent if applicable.