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

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