Share via

Industries - Standardized Data API

  • Article

The industries API provides standardized industry data across the LinkedIn platform.

Supported Methods

GET | BATCH_GET | GET_ALL

Versions

The industries API currently supports only the static version (V1) of industry data from LinkedIn. To access other available versions of the Industry Taxonomy, please refer to the Industry Taxonomy Versions API and use the appropriate endpoint to retrieve the desired version.

Schema

Field Name Description
id Industry ID.
$URN Standardized industry URN.
name Industry name in various locales. Represented as MultiLocaleString type.

GET

GET https://api.linkedin.com/v2/industries/{id}?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.

Sample Response

{
    "name": {
        "localized": {
            "en_US": "Supermarkets"
        }
    },
    "id": 22,
    "$URN": "urn:li:industry:22"
}

BATCH_GET

GET https://api.linkedin.com/v2/industries?ids={id1}&ids={id2}&ids={id3}

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.

Sample Response

{
    "statuses": {},
    "results": {
        "22": {
            "name": {
                "localized": {
                    "en_US": "Supermarkets"
                }
            },
            "id": 22,
            "$URN": "urn:li:industry:22"
        },
        "23": {
            "name": {
                "localized": {
                    "en_US": "Food Production"
                }
            },
            "id": 23,
            "$URN": "urn:li:industry:23"
        }
    },
    "errors": {}
}

GET_ALL

GET https://api.linkedin.com/v2/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.

Sample Response

{
    "elements": [
        {
            "name": {
                "localized": {
                    "en_US": "Sporting Goods"
                }
            },
            "id": 20,
            "$URN": "urn:li:industry:20"
        },
        {
            "name": {
                "localized": {
                    "en_US": "Tobacco"
                }
            },
            "id": 21,
            "$URN": "urn:li:industry:21"
        },
        {
            "name": {
                "localized": {
                    "en_US": "Supermarkets"
                }
            },
            "id": 22,
            "$URN": "urn:li:industry:22"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": []
    }
}