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": {}
}
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