Places
Place taxonomy that is used to standardize data across the LinkedIn platform. Use this API to retrieve standardized URNs and their names.
Supported Methods
Region Schema
Field Name | Description |
---|---|
adminLevel | The administrative level of the place. Valid values:
|
country | The country URN that owns the place. |
$URN | Standardized place URN |
name | Place name in various locales. Represented as LocaleString type. |
parent | The parent place URN for this place. Can be null when this place is the top-level administrative division. |
placeCode | The unique code within a country/region to identify the place. |
GET
GET https://api.linkedin.com/v2/places/country={countryURN}&placeCode={placeCode}?locale.language=en&locale.country=US
Parameters
Field Name | Description | |
---|---|---|
locale | The locale the seniority 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:place:(urn:li:country:us,7-1-0-43-18)",
"adminLevel": "CITY",
"country": "urn:li:country:us",
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "San Francisco, California"
},
"parent": "urn:li:place:(urn:li:country:us,7-1-0-43)",
"placeCode": "7-1-0-43-18"
}
BATCH GET
GET https://api.linkedin.com/v2/places?ids[0].country={countryURN1}&ids[0].placeCode={placeCode1}&ids[1].country={countryURN2}&ids[1].placeCode={placeCode2}
Parameters
Field Name | Description | |
---|---|---|
locale | The locale the seniority 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": {
"country=urn%3Ali%3Acountry%3Aus&placeCode=1-1": {
"$URN": "urn:li:place:(urn:li:country:us,1-1)",
"adminLevel": "STATE",
"country": "urn:li:country:us",
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "California"
},
"parent": "urn:li:place:(urn:li:country:us,1)",
"placeCode": "1-1"
},
"country=urn%3Ali%3Acountry%3Aus&placeCode=1-1-0-43-18": {
"$URN": "urn:li:place:(urn:li:country:us,1-1-0-43-18)",
"adminLevel": "CITY",
"country": "urn:li:country:us",
"name": {
"locale": {
"country": "US",
"language": "en"
},
"value": "San Francisco, California"
},
"parent": "urn:li:place:(urn:li:country:us,1-1)",
"placeCode": "7-1-0-43-18"
}
},
"statuses": {}
}
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