Super Titles - Standardized Data API

  • Article

The superTitles API is a collection of standard base job title entities.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name Description
id Super title ID.
$URN Standardized superTitle URN.
name Super title name in various locales. Represented as MultiLocaleString type.

GET

GET https://api.linkedin.com/v2/superTitles/{id}?locale=en_US

Parameters

Field Name Required Description
locale No The locale the super title data is requested in. en_US locale is used if locale is not provided or supported. Formatted with a lowercase, two-letter language code as defined by ISO-639, an underscore, and an uppercase two-letter country code as defined by ISO-3166. For example, en_US.

Sample Response

{
    "$URN": "urn:li:superTitle:408",
    "id": 408,
    "name": {
        "localized": {
            "en_US": "Jeweler"
        }
    }
}

BATCH_GET

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

Parameters

Field Name Required Description
locale No The locale the super title data is requested in. en_US locale is used if locale is not provided or supported. Formatted with a lowercase, two-letter language code as defined by ISO-639, an underscore, and an uppercase, two-letter country code as defined by ISO-3166 (for example, en_US).

Sample Response

{
    "errors": {},
    "results": {
        "407": {
            "$URN": "urn:li:superTitle:407",
            "id": 407,
            "name": {
                "localized": {
                    "en_US": "Software Developer"
                }
            }
        },
        "408": {
            "$URN": "urn:li:superTitle:408",
            "id": 408,
            "name": {
                "localized": {
                    "en_US": "Jeweler"
                }
            }
        }
    },
    "statuses": {}
}

GET_ALL

GET https://api.linkedin.com/v2/superTitles

Parameters

Field Name Required Description
locale No The locale the super title data is requested in. en_US locale is used if locale is not provided or supported. Formatted with a lowercase, two-letter language code as defined by ISO-639, an underscore, and an uppercase, two-letter country code as defined by ISO-3166 (for example, en_US).

Sample Response

{
    "elements": [
        {
            "$URN": "urn:li:superTitle:408",
            "id": 408,
            "name": {
                "localized": {
                    "en_US": "Jeweler"
                }
            }
        },
        {
            "$URN": "urn:li:superTitle:407",
            "id": 407,
            "name": {
                "localized": {
                    "en_US": "Software Developer"
                }
            }
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}