Countries
Country/region taxonomy is used to standardize data across the LinkedIn platform. Use this API to retrieve standardized URNs and their names.
Supported Methods
GET | BATCH_GET | GET_ALL | FINDER countryGroup
Country Schema
Field Name | Description |
---|---|
countryCode | The country code. |
countryGroup | The country group URN that this country/region belongs to. |
$URN | Standardized country URN |
name | Country/region name in various locales. Represented as LocaleString type. |
GET
GET https://api.linkedin.com/v2/countries/{countryCode}?locale.language=en&locale.country=US
Parameters
Field Name | Sub-Field Name | Description |
---|---|---|
locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not 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
{
"$URN": "urn:li:country:us",
"countryCode": "us",
"countryGroup": "urn:li:countryGroup:NA",
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "United States"
}
}
BATCH GET
GET https://api.linkedin.com/v2/countries?ids={countryCode1}&ids={countryCode2}&ids={countryCode3}
Parameters
Field Name | Sub-Field Name | Description |
---|---|---|
locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not 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
{
"errors": {},
"results": {
"ca": {
"$URN": "urn:li:country:ca",
"countryCode": "ca",
"countryGroup": "urn:li:countryGroup:NA",
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "Canada"
}
},
"us": {
"$URN": "urn:li:country:us",
"countryCode": "us",
"countryGroup": "urn:li:countryGroup:NA",
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "United States"
}
}
},
"statuses": {}
}
GET ALL
GET https://api.linkedin.com/v2/countries
Parameters
Field Name | Sub-Field Name | Description |
---|---|---|
locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not 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": {
"locale": {
"country": "US",
"language": "en"
},
"value": "Andorra"
},
"countryGroup": "urn:li:countryGroup:EU",
"$URN": "urn:li:country:ad",
"countryCode": "ad"
},
{
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "United Arab Emirates"
},
"countryGroup": "urn:li:countryGroup:ME",
"$URN": "urn:li:country:ae",
"countryCode": "ae"
},
...
],
"paging": {
"count": 10,
"start": 0,
"links": []
}
}
FINDER countryGroup
Find all countries/regions in a country group:
GET https://api.linkedin.com/v2/countries?q=countryGroup&countryGroup={countryGroupURN}
Parameters
Field Name | Sub-Field Name | Description |
---|---|---|
countryGroup | The country group URN. | |
locale | The locale the country/region data is requested in. "en_US" locale will be used if locale is not provided or not 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": {
"locale": {
"country": "US",
"language": "en"
},
"value": "Canada"
},
"countryGroup": "urn:li:countryGroup:NA",
"$URN": "urn:li:country:ca",
"countryCode": "ca"
},
...
],
"paging": {
"count": 10,
"start": 0,
"links": []
}
}
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