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

{
    "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.

Type of Change	Old Name	New Name
removed	Industrial Design Firms	--
removed (generalized on parent Waste Management and Recycling Organizations)	Waste Organizations	--
removed intermediate node	Entertainment Companies	--
removed intermediate node	Miscellaneous Manufacturers	--
removed intermediate node	Recreation Services	--
removed and specialized	Business Software Companies	multiple categories
removed and specialized	Cloud Computing Providers	multiple categories
removed and specialized	Data Providers	multiple categories
removed and specialized	Enterprise Software Companies	multiple categories
removed and specialized (see Basic Materials)	Building Materials Companies	multiple categories
removed and specialized	Event Management Companies	Event Management Services Event Management Software
removed and specialized	Internet Of Things Companies	Smart Devices Manufacturers IoT Management Platforms
removed and specialized	Video Messaging Companies	Video Communications Software Video Conferencing Software
renamed and changed scope	Building Materials Retailers	Construction Supplies Retailers
renamed and changed scope	Computer Storage Companies	Storage Devices Manufacturers Cloud File Storage Software
renamed and changed scope	Cultural Services	Cultural Centers
renamed and changed scope	Fitness And Sports Centers	Fitness Centers
renamed and changed scope	Home Appliance Manufacturers	Appliance Manufacturers
renamed and changed scope	Machine Manufacturers	Industrial Machinery Manufacturers
renamed and changed scope	Metal Companies	Mining Companies
renamed and changed scope	Metal Mining Companies	Mining Companies
renamed and changed scope	Networking Companies	Networking Hardware Manufacturers
renamed and changed scope	Online Learning Companies	Education Platforms
renamed and changed scope	Recruiting And Employment Agencies	Employment Services
renamed and changed scope	Recyclable Material Companies	Recycling Organizations
renamed and changed scope	Research Institutes And Labs	Research Institutes
renamed and changed scope	Soap And Cosmetics Companies	Beauty Care Companies
renamed and changed scope	Software Consulting Firms	Information Technology Services Companies
renamed and changed scope	Security Companies	Private Security Companies
renamed	Appliance Repair and Maintenance	Appliance Repair Services
renamed	Consumer Service Companies	Consumer Services
renamed	Digital Currencies Companies	Cryptocurrency Companies
renamed	Drink Companies	Beverage Companies
renamed	Floor Covering Stores	Floor Covering Retailers
renamed	Florist Companies	Floral Retailers
renamed	Freight And Logistics Companies	Freight Forwarding Services
renamed	Hardware Stores	Hardware Retailers
renamed	Law Firms	Legal Services Legal Software
renamed	Motion Picture Companies	Entertainment Production Companies
renamed	Moving And Storage Companies	Moving And Storage Services
renamed	National Parks	Parks And Recreation Area
renamed	Open Source Software Organizations	Open Source Software Companies
renamed	Pet Shops	Pet Stores
renamed	Photographic Equipment And Supplies	Photographic Equipment Stores
renamed	Plumbing Equipment And Supplies	Plumbing Equipment Retailers
renamed	Postal Organizations	Postal Services
renamed	Social Networking Companies	Social Network Platforms
renamed	Superstores	Department Stores
renamed	Toy Manufacturers	Toys Companies
renamed	Vehicle Repair And Maintenance	Vehicle Repair Services
renamed	Advertising Companies	Advertising Services
renamed	Artificial Intelligence Companies	Artificial Intelligence Software
renamed	Bioinformatics Organizations	Life Sciences Software
renamed	Computer Vision Companies	Computer Vision Software
renamed	CRM Software Companies	CRM Software
renamed	Data Analytics Companies	Data Analytics Software
renamed	Database Companies	Database Software
renamed	Design Companies	Design Services
renamed	Graphic Design Companies	Graphic Design Software
renamed	Marketing Companies	Marketing Services
renamed	Natural Language Processing Companies	Natural Language Processing Software
renamed	Security Software Companies	Security Software
renamed	Virtual Reality Companies	Extended Reality Software
renamed	Web Design Companies	Web Developers Website Design Services