Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
Supported Methods
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
.