API

API для общих данных

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

Описание

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

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

Copy
GET /system/search-engines

Результат

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

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

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

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

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

Описание

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

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

Copy
GET /system/google-regions

Результат

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

Copy
[
{ "name": "Kabul, Kabul, Afghanistan", "region_id": 1 },
...]

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

Описание

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

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

Copy
GET /system/google-langs

Результат

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

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

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

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

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

Описание

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

Параметры

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

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

Copy
GET /system/volume-regions

Результат

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

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

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

Copy
[
{
"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 слов.

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

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

Результат

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

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

Пример

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

Ошибки

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

Learn how SE Ranking’s API can boost your SEO!

Hi! Meet our product expert, Alex.

He’ll walk you through the API and show you how to get the most out of it.

  • Enjoy a tailored demo on integrating rich, structured SEO data into your stack.
  • Pin down every tech detail live—auth, endpoints, rate limits, data formats.
  • Compare usage tiers and pricing so you can unlock maximum data value.

Request a free demo to see our tools and integrations in action

Нажав на эту кнопку, вы соглашаетесь с Условия обслуживания SE Ranking