$ npx scrapering initCreate accountStart for free
SERP Location

Available SERP Cities

Retrieve the list of cities for a given country. Used to get canonical_name for Google geo-targeting and yandex_lr codes for Yandex geo-targeting.

Endpoint

GET /api/parsing/v1/geo/countries/{countryCode}

Path Parameters

NameTypeRequiredDescription
countryCodestringyesISO country code (e.g. US, GB)

Example Request

curl https://app.scrapering.com/api/parsing/v1/geo/countries/US \
  --header 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "country_code": "US",
  "cities": [
    {
      "name": "New York",
      "canonical_name": "New York,New York,United States",
      "yandex_lr": 202,
      "name_ru": "Нью-Йорк"
    },
    {
      "name": "Los Angeles",
      "canonical_name": "Los Angeles,California,United States",
      "yandex_lr": 20047,
      "name_ru": "Лос-Анджелес"
    },
    {
      "name": "Aaronsburg",
      "canonical_name": "Aaronsburg,Pennsylvania,United States",
      "yandex_lr": null,
      "name_ru": null
    }
  ]
}

Response Fields

FieldTypeDescription
country_codestringISO country code
cities[].namestringCity name in English
cities[].canonical_namestringFull location string for Google geo-targeting
cities[].yandex_lrnumber | nullYandex region code for geo-targeting. null if not supported
cities[].name_rustring | nullCity name in Russian. null if not available

Using Location Data

Google SERP — pass canonical_name as canonicalLocationName and country_code.toLowerCase() as gl:

{
  "q": "pizza delivery",
  "count": 10,
  "gl": "us",
  "canonicalLocationName": "New York,New York,United States"
}

Yandex SERP — pass yandex_lr as region. Note: not all cities have a yandex_lr value.

{
  "q": "pizza delivery",
  "count": 10,
  "region": 202
}

Next steps