Regions

  • Article

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 countries | FINDER states | FINDER standardizedLocation

Region Schema

Field Name Description
country The country URN for this region.
id The region code.
$URN Standardized region URN
name Region name in various locales. Represented as  LocaleString type.
states The state URNs for this region. Represents an array and defaults to an empty.

GET

GET https://api.linkedin.com/v2/regions/{id}?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:region:84",
    "country": "urn:li:country:us",
    "id": 84,
    "name": {
        "locale": {
            "country": "US",
            "language": "en"
        },
        "value": "San Francisco Bay Area"
    },
    "states": [
        "urn:li:state:(urn:li:country:us,CA)"
    ]
}

BATCH GET

GET https://api.linkedin.com/v2/regions?ids={id1}&ids={id2}&ids={ids3}

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": {
        "82": {
            "$URN": "urn:li:region:82",
            "country": "urn:li:country:us",
            "id": 82,
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "Sacramento, California Area"
            },
            "states": [
                "urn:li:state:(urn:li:country:us,CA)",
                "urn:li:state:(urn:li:country:us,NV)"
            ]
        },
        "84": {
            "$URN": "urn:li:region:84",
            "country": "urn:li:country:us",
            "id": 84,
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "San Francisco Bay Area"
            },
            "states": [
                "urn:li:state:(urn:li:country:us,CA)"
            ]
        }
    },
    "statuses": {}
}

GET ALL

GET https://api.linkedin.com/v2/regions

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

{
  "elements": [
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "Sacramento, California Area"
      },
      "country": "urn:li:country:us",
      "id": 82,
      "$URN": "urn:li:region:82",
      "states": [
        "urn:li:state:(urn:li:country:us,CA)",
        "urn:li:state:(urn:li:country:us,NV)"
      ]
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "San Francisco Bay Area"
      },
      "country": "urn:li:country:us",
      "id": 84,
      "$URN": "urn:li:region:84",
      "states": [
        "urn:li:state:(urn:li:country:us,CA)"
      ]
    },
    ...
  ],
  "paging": {
    "count": 10,
    "start": 0
  }
}

FINDER countries

GET https://api.linkedin.com/v2/regions?q=countries&countries={countryURN1}&countries={countryURN2}&countries={countryURN3}

Parameters

Field Name Sub-Field Name Description
countries   The country URNs.
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 of urn:li:country:us and urn:li:country:ca

{
  "elements": [
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "Toronto, Canada Area"
      },
      "country": "urn:li:country:ca",
      "id": 4876,
      "$URN": "urn:li:region:4876",
      "states": [
        "urn:li:state:(urn:li:country:ca,ON)"
      ]
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "Sacramento, California Area"
      },
      "country": "urn:li:country:us",
      "id": 82,
      "$URN": "urn:li:region:82",
      "states": [
        "urn:li:state:(urn:li:country:us,CA)",
        "urn:li:state:(urn:li:country:us,NV)"
      ]
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "San Francisco Bay Area"
      },
      "country": "urn:li:country:us",
      "id": 84,
      "$URN": "urn:li:region:84",
      "states": [
        "urn:li:state:(urn:li:country:us,CA)"
      ]
    },
    ...
  ],
  "paging": {
    "count": 10,
    "start": 0
  }
}

FINDER states

GET https://api.linkedin.com/v2/regions?q=states&states={stateURN1}&states={stateURN2}&states={stateURN3}

Parameters

Field Name Sub-Field Name Description
states   The state URNs.
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 of urn:li:state(urn:li:country:us,CA) and urn:li:state(urn:li:country:us,NY)

{
  "elements": [
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "Greater New York City Area"
      },
      "country": "urn:li:country:us",
      "id": 70,
      "$URN": "urn:li:region:70",
      "states": [
        "urn:li:state:(urn:li:country:us,NY)"
      ]
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "Sacramento, California Area"
      },
      "country": "urn:li:country:us",
      "id": 82,
      "$URN": "urn:li:region:82",
      "states": [
        "urn:li:state:(urn:li:country:us,CA)",
        "urn:li:state:(urn:li:country:us,NV)"
      ]
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "San Francisco Bay Area"
      },
      "country": "urn:li:country:us",
      "id": 84,
      "$URN": "urn:li:region:84",
      "states": [
        "urn:li:state:(urn:li:country:us,CA)"
      ]
    },
    ...
  ],
  "paging": {
    "count": 10,
    "start": 0
  }
}

FINDER standardizedLocation

GET https://api.linkedin.com/v2/regions?q=standardizedLocation&standardizedLocation={standardizedLocationURN}

Parameters

Field Name Sub-Field Name Description
standardizedLocation   The standardized location URN.
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

{
    "elements": [
        {
            "$URN": "urn:li:region:14",
            "country": "urn:li:country:us",
            "id": 14,
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "Greater Chicago Area"
            },
            "states": [
                "urn:li:state:(urn:li:country:us,IL)",
                "urn:li:state:(urn:li:country:us,IN)",
                "urn:li:state:(urn:li:country:us,WI)"
            ]
        }
    ],
    "paging": {
        "count": 10,
        "start": 0
    }
}