/v2/countries

Country 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 countryGroup

Country Schema

Field Name Description
countryCode The country code.
countryGroup The country group URN that this country belongs to.
$URN Standardized country URN
name Country name in various locales. Represented as  LocaleString type.

GET

GET https://api.linkedin.com/v2/countries/{countryCode}?locale.language=en&locale.country=US

Parameters

Field Name Sub-Field Name Description
locale   The locale the country 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:country:us",
    "countryCode": "us",
    "countryGroup": "urn:li:countryGroup:NA",
    "name": {
        "locale": {
            "country": "US",
            "language": "en"
        },
        "value": "United States"
    }
}

BATCH GET

GET https://api.linkedin.com/v2/countries?ids={countryCode1}&ids={countryCode2}&ids={countryCode3}

Parameters

Field Name Sub-Field Name Description
locale   The locale the country 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": {
        "ca": {
            "$URN": "urn:li:country:ca",
            "countryCode": "ca",
            "countryGroup": "urn:li:countryGroup:NA",
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "Canada"
            }
        },
        "us": {
            "$URN": "urn:li:country:us",
            "countryCode": "us",
            "countryGroup": "urn:li:countryGroup:NA",
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "United States"
            }
        }
    },
    "statuses": {}
}

GET ALL

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

Parameters

Field Name Sub-Field Name Description
locale   The locale the country 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": "Andorra"
      },
      "countryGroup": "urn:li:countryGroup:EU",
      "$URN": "urn:li:country:ad",
      "countryCode": "ad"
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "United Arab Emirates"
      },
      "countryGroup": "urn:li:countryGroup:ME",
      "$URN": "urn:li:country:ae",
      "countryCode": "ae"
    },
    ...
  ],
  "paging": {
    "count": 10,
    "start": 0,
    "links": []
  }
}

FINDER countryGroup

Find all countries in a country group:

GET https://api.linkedin.com/v2/countries?q=countryGroup&countryGroup={countryGroupURN}

Parameters

Field Name Sub-Field Name Description
countryGroup   The country group URN.
locale   The locale the country 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": "Canada"
      },
      "countryGroup": "urn:li:countryGroup:NA",
      "$URN": "urn:li:country:ca",
      "countryCode": "ca"
    },
    ...
  ],
  "paging": {
    "count": 10,
    "start": 0,
    "links": []
  }
}