Seniorities - Standardized Data API

  • Article

The seniorities API provides standardized job seniority data across the LinkedIn platform.

Supported Methods

GET | GET_ALL

Schema

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

GET

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

Parameters

Field Name Sub-Field Name Description
locale The locale the seniority 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": "Training"
        }
    },
    "id": 2,
    "$URN": "urn:li:seniority:2"
}

GET_ALL

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

Parameters

Field Name Sub-Field Name Description
locale The locale the seniority 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": "Unpaid"
                }
            },
            "id": 1,
            "$URN": "urn:li:seniority:1"
        },
        {
            "name": {
                "localized": {
                    "en_US": "Partner"
                }
            },
            "id": 9,
            "$URN": "urn:li:seniority:9"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": [
            {
                "rel": "next",
                "href": "/v2/seniorities?count=10&start=10",
                "type": "application/json"
            }
        ]
    }
}