Industry Taxonomy Versions - Standardized Data API

  • Article

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