Partager via

Places

  • Article

Place taxonomy that is used to standardize data across the LinkedIn platform. Use this API to retrieve standardized URNs and their names.

Supported Methods

GET | BATCH_GET

Region Schema

Field Name Description
adminLevel The administrative level of the place. Valid values:
  • COUNTRY_AREA - A large region of the country that can span over more than one state or province.
  • STATE - An aggregation of counties and/or cities. Usually a state or a province.
  • COUNTY - An aggregation of cities. Usually a county, jurisdiction, or department.
  • CITY - A group of postal codes. Usually a city or town.
  • null - None of the above.
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": {}
}