/v2/countryGroups

Country group taxonomy is used to standardize data across the LinkedIn platform. Country group is a group of countries that are geographically and economically linked. Use this API to retrieve standardized URNs and their names.

Supported Methods

GET | BATCH_GET | GET_ALL

Country Group Schema

Field Name Description
countryGroupCode The country group code.
$URN Standardized country group URN
name Country group name in various locales. Represented as LocaleString type.

GET

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

Parameters

Field Name Sub-Field Name Description
locale The locale the country group 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:countryGroup:AF",
    "countryGroupCode": "AF",
    "name": {
        "locale": {
            "country": "US",
            "language": "en"
        },
        "value": "Africa"
    }
}

BATCH GET

GET https://api.linkedin.com/v2/countryGroups?ids={countryGroupCode1}&ids={countryGroupCode2}&ids={countryGroupCode3}

Parameters

Field Name Sub-Field Name Description
locale The locale the country group 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": {
        "AF": {
            "$URN": "urn:li:countryGroup:AF",
            "countryGroupCode": "AF",
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "Africa"
            }
        },
        "NA": {
            "$URN": "urn:li:countryGroup:NA",
            "countryGroupCode": "NA",
            "name": {
                "locale": {
                    "country": "US",
                    "language": "en"
                },
                "value": "North America"
            }
        }
    },
    "statuses": {}
}

GET ALL

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

Parameters

Field Name Sub-Field Name Description
locale The locale the country group 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": "Africa"
      },
      "$URN": "urn:li:countryGroup:AF",
      "countryGroupCode": "AF"
    },
    {
      "name": {
        "locale": {
          "country": "US",
          "language": "en"
        },
        "value": "Antarctica"
      },
      "$URN": "urn:li:countryGroup:AQ",
      "countryGroupCode": "AQ"
    },
    ...
  ],
  "paging": {
    "count": 10,
    "start": 0,
    "links": []
  }
}