Industries - Standardized Data API

  • Article

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

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.

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