nofollow
BLACKFRIDAY2018

-30% скидки на любую оплату
подробнее

Черная пятница в SE Ranking: 30% скидки на любую оплату. подробнее

Общие данные

Список поисковых систем

Описание

Метод позволяет получить список доступных поисковых систем, которые можно добавить в проекты для отслеживания позиций, с возможными регионами.

Формат запроса

GET /system/search-engines

Результат

В случае успеха сервер возвращает массив со списком доступных поисковых систем.

Имя Описание
id Уникальный идентификатор поисковой системы
name Название
region_id ID региона
type Тип поисковой системы

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

[
    {
        "id": "200",
        "name": "Google USA",
        "regionid": "182"
    },
    {
        "id": "201",
        "name": "Google Andorra",
        "regionid": "4"
    },
    {
        "id": "202",
        "name": "Google United Arab Emirates",
        "regionid": "178"
    },

...
]

Список доступных регионов для Яндекса

Описание

Метод позволяет получить список доступных регионов для поисковой системы Яндекс.

Формат запроса

GET /system/yandex-regions

Результат

В случае успеха сервер возвращает массив, содержащий список регионов для Яндекса, и их уникальные идентификаторы.

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

{
    "1": "Москва и область",
    "2": "Санкт-Петербург",
    "3": "Центр",
    "4": "Белгород",
    "5": "Иваново",
    ...
    "122068": "Амбролаури",
    "122069": "Зугдиди",
    "122070": "Ахалцихе",
    "123580": "Теджен"
}

Список языков для Google

Описание

Метод позволяет получить полный список возможных языков для поисковой системы Google.

Формат запроса

GET /system/google-langs

Результат

В случае успеха сервер возвращает массив с полным списком кодов языков и их названиями для поисковой системы Google.

Имя Обязательный Описание
lang_code Да Код языка
name Да Название языка

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

[
    "de":"Deutsch",
    "en":"English",
    "es":"español"
    ...
]

Список регионов для получения частотности

Описание

Метод позволяет получить список всех регионов, по которым можно проверить частотность в онлайн-сервисе SE Ranking.

Параметры

Для этого метода нет параметров.

Формат запроса

GET /system/volume-regions

Результат

В случае успеха сервер возвращает массив со списком регионов.

Имя Обязательный Описание
id Да Уникальный идентификатор региона
name Нет Название региона

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

[
    {
        "id": "180",
        "name": "United Kingdom",
    },
    {
        "id": "182",
        "name": "USA",
    },

    ...
]

Получение частотности для ключевых слов

Описание

Метод позволяет получить частотность для указанного региона и списка ключевых слов.

Параметры

Имя Обязательный Описание
region_id Да ID региона. Все регионы и их ID можно получить в методе /system/volume-regions
keyword Да Массив ключевых слов, для которых будет получена частотность. Кириллические ключевые слова в URL должны быть в url-encoded, т.е. "ключ" превратится в %D0%BA%D0%BB%D1%8E%D1%87 В списке может быть максимум 10 слов.
yandex_region_code Нет Код региона из wordstat (необязательный параметр, если указан – вернётся частотность из Яндекс Вордстат, если нет – из Google)

Формат запроса

GET /system/volume?regionid=12&keyword[]=%D0%BA%D0%BB%D1%8E%D1%87

Результат

В случае успеха сервер возвращает массив ключевых слов с частотностью.

Имя Обязательный Описание
volume Да Частотность ключевого слова

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

{
    "key1": "1000",
    "key2": "10000"
    ...
    "keyN": "100000"
}

Ошибки

HTTP-код Сообщение об ошибке
400 Not enough params. region_id and keyword required
400 Incorrect region_id
404 No data