How You Can Help Ukrainians Today (SE Ranking Team Included)Learn here

API для SEO данных

API SEO Данные — API предназначено для получения ТОП 100 поисковой выдачи Google и Yandex (URL, сниппет, позиция сайта) по ключевым фразам без создания проекта в сервисе SE Ranking.

Стоимость одного запроса к API SEO Данные:

0.03 р. / $0.003

Добавление ключевого слова

Описание

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

Параметры

ИмяОбязательныйОписание
queryДаПоисковый запрос или массив запросов (запрос максимум 255 символов, массив, максимум 1000 запросов)
engine_idДаУникальный идентификатор поисковой системы. Получить полный список поисковых систем с уникальными идентификаторами можно в методе GET /system/search-engines (только type google или yandex)
region_nameНетНазвание региона для поиска (только для поисковой системы Google)

 

region_idНетУникальный идентификатор региона для поисковой системы Яндекс. Получить полный список идентификаторов регионов для Яндекса можно в методе GET /system/yandex-regions

 

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

POST /parsing/serp/tasks
{
«engine_id»: 1,
«region_id»: 140,
«query»: «text»
or
«query»: [«text», «text2»]
}

Результат

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

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

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

[{
«query»: :»text»,
«task_id»: 123456
}]

Ошибки

HTTP-кодСообщение об ошибке
403Empty balance
400Invalid engine_id
400Invalid region_id
400Empty query
400Query $query too long

Проверка статуса и получение результата проверки

Описание

Метод позволяет получить результат по ключевому слову, ранее добавленному в очередь. Если снятие позиций по ключевому слову еще не завершено, метод вернет статус. Результаты хранятся 24 часа, затем они удаляются.

Параметры

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

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

GET /parsing/serp/tasks/{task_id}

Результат

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

Если запрос в очереди, возвращает статус: processing.

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

{
«status»: «processing»
}

Если проверка завершена, сервер возвращает результаты проверки. В случае успеха сервер возвращает массив, содержащий результаты из ТОП 100 выдачи по ключевому слову.

ИмяОбязательныйОписание
positionДаПозиция страницы в ТОП 100
urlДаСсылка страницы, которая ранжируется в ТОП 100
titleДаЗаголовок страницы в ТОП 100
snippetДаСниппет, описание страницы в ТОП 100
cache_urlНетСсылка на кэшированную копию страницы, которая ранжируется в ТОП 100

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

{
«results»: [
{
«position»: «1»,
«url»: «https://www.pizzahut.com/»,
«title»: «Pizza Hut: Pizza Delivery»,
«snippet»: «Order pizza online for fast delivery or carryout from a store near you. View our full menu, see nutritional information, find store locations, and more.«,
«cache_url»: «https://webcache.googleusercontent.com/search?q=cache:oiTvlHsuOeEJ:https://www.pizzahut.com/+&cd=4&hl=en&ct=clnk&gl=us»
},

«position»: «99»,
«url»: «https://techcrunch.com/2018/08/20/google-doctor-fork/»,
«title»: «Google created a fake pizza brand to test out creative strategies for …»,
«snippet»: «Aug 20, 2018 — Google’s Unskippable Labs team has been testing ad effectiveness in a compelling new way: It created a fake pizza brand called Doctor Fork, …«,
«cache_url»: «https://webcache.googleusercontent.com/search?q=cache:wi5sKCy0ResJ:https://techcrunch.com/2018/08/20/google-doctor-fork/+&cd=120&hl=en&ct=clnk&gl=us»
}
]
}

Ошибки

HTTР-кодСообщение об ошибке
404Task not found

Список всех запросов пользователя

Описание

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

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

GET /parsing/serp/tasks

Результат

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

ИмяОписание
idУникальный идентификатор ключевого слова
queryКлючевое слово
region_nameНазвание региона для поиска (только для поисковой системы Google)
engine_idУникальный идентификатор поисковой системы. Получить полный список поисковых систем с уникальными идентификаторами можно в методе /system/search-engines.

 

region_idУникальный идентификатор региона для поисковой системы Яндекс. Получить полный список идентификаторов регионов для поисковой системы Яндекс можно в методе /system/yandex-regions

 

addedДата добавления ключевого слова в очередь
is_completedСтатус проверки ключевого слова (1 – проверено, 0 – нет)

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

{
«tasks»: [
{
«id»: «18638740»,
«query»: «book»,
«region_name»: null,
«engine_id»: «411»,
«region_id»: «213»,
«added»: «2018-08-28 10:25:29»,
«is_completed»: «0»
},

{
«id»: «18639398»,
«query»: «pizza»,
«region_name»: «New York»,
«engine_id»: «200»,
«region_id»: «0»,
«added»: «2018-08-28 12:25:52»,
«is_completed»: «1»
}
]
}