$ npx parsering initСоздать аккаунтНачать бесплатно
Геолокация SERP

Доступные города

Получите список городов для указанной страны. Используется для получения canonical_name для геотаргетинга Google и кодов yandex_lr для геотаргетинга Яндекса.

Эндпоинт

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

Параметры пути

ПараметрТипОбязательныйОписание
countryCodestringдаISO-код страны (например, US, GB)

Пример запроса

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

Пример ответа

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

Поля ответа

ПолеТипОписание
country_codestringISO-код страны
cities[].namestringНазвание города на английском
cities[].canonical_namestringПолная строка местоположения для геотаргетинга Google
cities[].yandex_lrnumber | nullКод региона Яндекса для геотаргетинга. null, если не поддерживается
cities[].name_rustring | nullНазвание города на русском. null, если недоступно

Использование данных о местоположении

Google SERP — передайте canonical_name как canonicalLocationName и country_code.toLowerCase() как gl:

{
  "q": "доставка пиццы",
  "count": 10,
  "gl": "ru",
  "canonicalLocationName": "Moscow,Moscow,Russia"
}

Yandex SERP — передайте yandex_lr как region. Обратите внимание: не у всех городов есть значение yandex_lr.

{
  "q": "доставка пиццы",
  "count": 10,
  "region": 213
}

Следующие шаги