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
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
.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for