Titles - Standardized Data API

The titles API provides standardized job title data across the LinkedIn platform. Each position or job is mapped to a list of titles and their higher granularities. titles is a child of the superTitles entity.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name Description
function The function URN that this title belongs to.
id Title ID.
$URN Standardized title URN.
name Title name in various locales. Represented as MultiLocaleString type.
superTitle The superTitle URN that this title belongs to.

GET

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

Parameters

Field Name Required Description
locale No The locale the 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

{
    "function": "urn:li:function:8",
    "name": {
        "localized": {
            "en_US": "Software Engineer"
        }
    },
    "superTitle": "urn:li:superTitle:407",
    "id": 9,
    "$URN": "urn:li:title:9"
}

BATCH_GET

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

Parameters

Field Name Required Description
locale No The locale the 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

{
    "statuses": {},
    "results": {
        "9": {
            "function": "urn:li:function:8",
            "name": {
                "localized": {
                    "en_US": "Software Engineer"
                }
            },
            "superTitle": "urn:li:superTitle:407",
            "id": 9,
            "$URN": "urn:li:title:9"
        },
        "10": {
            "function": "urn:li:function:8",
            "name": {
                "localized": {
                    "en_US": "Engineer"
                }
            },
            "superTitle": "urn:li:superTitle:426",
            "id": 10,
            "$URN": "urn:li:title:10"
        },
        "11": {
            "function": "urn:li:function:25",
            "name": {
                "localized": {
                    "en_US": "Account Manager"
                }
            },
            "superTitle": "urn:li:superTitle:469",
            "id": 11,
            "$URN": "urn:li:title:11"
        }
    },
    "errors": {}
}

GET_ALL

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

Parameters

Field Name Required Description
locale No The locale the 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": [
        {
            "function": "urn:li:function:6",
            "name": {
                "localized": {
                    "en_US": "Consultant"
                }
            },
            "superTitle": "urn:li:superTitle:288",
            "id": 3,
            "$URN": "urn:li:title:3"
        },
        {
            "function": "urn:li:function:8",
            "name": {
                "localized": {
                    "en_US": "Software Engineer"
                }
            },
            "superTitle": "urn:li:superTitle:407",
            "id": 9,
            "$URN": "urn:li:title:9"
        },
        {
            "function": "urn:li:function:8",
            "name": {
                "localized": {
                    "en_US": "Engineer"
                }
            },
            "superTitle": "urn:li:superTitle:426",
            "id": 10,
            "$URN": "urn:li:title:10"
        },
        {
            "function": "urn:li:function:25",
            "name": {
                "localized": {
                    "en_US": "Account Manager"
                }
            },
            "superTitle": "urn:li:superTitle:469",
            "id": 11,
            "$URN": "urn:li:title:11"
        },
    ],
    "paging": {
        "count": 50,
        "start": 0,
        "links": [
            {
                "rel": "next",
                "href": "/v2/titles?count=50&start=50",
                "type": "application/json"
            }
        ]
    }
}

Note

This request is limited to 50 objects per response due to size limit. Use pagination to retrieve all titles. For example, https://api.linkedin.com/v2/titles?start=50.