nofollow

Общие данные

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

Описание

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

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

GET /system/search-engines

Результат

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

ИмяОписание
idУникальный идентификатор поисковой системы
nameНазвание
region_idID региона
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-regions

Результат

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

[
{ «name»: «Kabul, Kabul, Afghanistan», «region_id»: 1 },
…]

Список языков для 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»

«key3»: «100000»
}

Ошибки

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