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": []
}
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour