Industry Taxonomy Versions - Standardized Data API

The Industry Taxonomy Versions - Standardized Data API provides standardized industry data across the LinkedIn platform. The API offers a hierarchical/tree structure to easily navigate through a comprehensive list of 400+ industries that are aligned with NAICS.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name	Description
id	Industry ID.
$URN	Standardized industry URN.
name	Industry name in various locales. Represented as MultiLocaleString type.
childrenIndustries	The URNs of the children industries associated with this node. It is empty if this industry is a leaf node.
parentIndustries	The URNs of the parent industry associated with this node. It is empty if this industry is a root node.

GET

GET https://api.linkedin.com/v2/industryTaxonomyVersions/{version}/industries/{id}?locale.language=en&locale.country=US

Parameters

Field Name	Sub-Field Name	Description
locale		The locale in which industry data is requested. The en_US locale is used if the locale is not provided or supported.
	language	A lowercase, two-letter language code as defined by ISO-639.
	country	An uppercase, two-letter country code as defined by ISO-3166.
version		Version of the industry data on LinkedIn. Currently supports V1_0 V2_5 V2_6 V2_7 DEFAULT points to the latest version

Sample Response

{
    "name": {
        "localized": {
            "en_US": "Food and Beverage Manufacturing"
        }
    },
    "parentIndustries": [
        "urn:li:industry:25"
    ],
    "id": 23,
    "childrenIndustries": [
        "urn:li:industry:65",
        "urn:li:industry:142",
        "urn:li:industry:481",
        "urn:li:industry:495",
        "urn:li:industry:504",
        "urn:li:industry:521",
        "urn:li:industry:528",
        "urn:li:industry:529"
    ]
}

BATCH_GET

GET https://api.linkedin.com/v2/industryTaxonomyVersions/{version}/industries?ids={id1}&ids={id2}&locale.language=en&locale.country=US

Parameters

Field Name	Sub-Field Name	Description
locale		The locale the industry data is requested in. en_US locale is used if locale is not provided or supported.
	language	A lowercase, two-letter language code as defined by ISO-639.
	country	An uppercase, two-letter country code as defined by ISO-3166.
version		Version of the industry data on LinkedIn. Currently supports V1_0 V2_5 V2_6 V2_7 DEFAULT points to the latest version

Sample Response

{
    "results": {
        "22": {
            "name": {
                "localized": {
                    "en_US": "Retail Groceries"
                }
            },
            "parentIndustries": [
                "urn:li:industry:1339"
            ],
            "id": 22,
            "childrenIndustries": []
        },
        "23": {
            "name": {
                "localized": {
                    "en_US": "Food and Beverage Manufacturing"
                }
            },
            "parentIndustries": [
                "urn:li:industry:25"
            ],
            "id": 23,
            "childrenIndustries": [
                "urn:li:industry:65",
                "urn:li:industry:142",
                "urn:li:industry:481",
                "urn:li:industry:495",
                "urn:li:industry:504",
                "urn:li:industry:521",
                "urn:li:industry:528",
                "urn:li:industry:529"
            ]
        }
    },
    "statuses": {},
    "errors": {}
}

GET_ALL

GET https://api.linkedin.com/v2/industryTaxonomyVersions/{version}/industries

Parameters

Field Name	Sub-Field Name	Description
locale		The locale the industry data is requested in. en_US locale is used if locale is not provided or supported.
	language	A lowercase, two-letter language code as defined by ISO-639.
	country	An uppercase, two-letter country code as defined by ISO-3166.
version		Version of the industry data on LinkedIn. Currently supports V1_0 V2_5 V2_6 V2_7 DEFAULT points to the latest version

Sample Response

{
    "paging": {
        "start": 0,
        "count": 10,
        "links": []
    },
    "elements": [
        {
            "name": {
                "localized": {
                    "en_US": "Chiropractors"
                }
            },
            "parentIndustries": [
                "urn:li:industry:13"
            ],
            "id": 2048,
            "childrenIndustries": []
        },
        {
            "name": {
                "localized": {
                    "en_US": "Defense and Space Manufacturing"
                }
            },
            "parentIndustries": [
                "urn:li:industry:1029"
            ],
            "id": 1,
            "childrenIndustries": []
        },
        {
            "name": {
                "localized": {
                    "en_US": "Software Development"
                }
            },
            "parentIndustries": [
                "urn:li:industry:6"
            ],
            "id": 4,
            "childrenIndustries": [
                "urn:li:industry:5",
                "urn:li:industry:3099",
                "urn:li:industry:3100",
                "urn:li:industry:3101",
                "urn:li:industry:3130",
                "urn:li:industry:109"
            ]
        },
        .
        .
        .
    ]
}