API Description

API управления проектами (сайтами)

API управления проектами позволяет работать с проектами (создание, редактирование, удаление), получать статистику по отдельным проектам или ключевым словам.

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

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

Запрос

Title of the code block
Copy
GET https://api4.seranking.com/sites

Результат

В случае успеха сервер вернет HTTP 200 и список сайтов.

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

Title of the code block
Copy
[{
«id»: 1,
"title": "zniqpf tfallp mykqeg",
"name": "Cronin.info",
"group_id": 0,
"is_active": 1,
"exact_url": 0,
"subdomain_match": 0,
"check_freq": "check_daily",
"check_day": null,
"guest_link": "https://seranking.com/guest.html? site_id=1&hv=0&hash=432&tab=detailed",
"keyword_count": 0,
}]

Параметры

ИмяОписание
idУникальный идентификатор сайта (ID)
titleНазвание сайта
nameURL сайта
group_idID группы сайтов
is_activeСтатус сайта 1 – активный, 0 – отложенный
exact_url1 – Позиции будут проверятся только для указанного URL без учета подпапок и поддоменов.
subdomain_match1 – Учитывать сабдомены в выдаче
check_freqПериодичность проверок
check_dayЕсли проверка еженедельная (check_weekly), то в этом параметре день недели. (от 1-понедельник до 7 – воскресенье).
Если проверка ежемесячная (check_monthly), то в параметре день месяца. (1-31)
guest_linkГостевая ссылка для просмотра статистики сайта без авторизации
keyword_countКоличество добавленных ключевых слов в проект

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

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

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/search-engines

Результат

В случае успеха сервер вернет HTTP 200 и список поисковых систем проекта

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

Title of the code block
Copy
{
"site_engine_id": 1,
"search_engine_id": 339,
"region_name": null,
"lang_code": "ru",
"merge_map": 0,
"business_name": null,
"phone": null,
"paid_results": 0,
"featured_snippet": 0,
"keyword_count": 10,
}

Параметры

ИмяОписание
search_engine_idID поисковой системы (см. GET /system/search-engines)
region_nameГеографическое название (область / город) на англ. языке. Только для Google
lang_codeКод языка (см. /system/google-langs)
merge_mapУчитывать выдачу Google Maps. 0 – не учитывать, 1 – учитывать, 2 – учитывать и отображать отдельно.
business_nameНазвание бизнеса. Для выдачи Google Maps
phoneТелефон компании. Для выдачи Google Maps
paid_resultsОтслеживать позиции в Google Adwords (1 – да, 0 – нет)
featured_snippetУчитывать блоки с ответами (1 – учитывать, 0 – нет)

Ошибки

HTTP-кодСообщение об ошибке
400Invalid keyword_id
400Invalid date
400No ids in request
404Unknown search_engine_id
404Unknown site_engine_id

Добавление поисковой системы в проект

Метод позволяет добавить новые поисковые системы в проект.

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

Title of the code block
Copy
POST https://api4.seranking.com/sites/{site_id}/search-engines

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

Title of the code block
Copy
{
"search_engine_id": 339,
"region_name": null,
"lang_code": "ru",
"merge_map": 0,
"business_name": null,
"phone": null,
"paid_results": 0,
"featured_snippet": 0
}

Параметры

ИмяОбязательныйОписание
search_engine_idДаID поисковой системы (см. GET /system/search-engines)
region_nameНетГеографическое название (область / город) на англ. языке. Только для Google (см. GET /system/google-regions)
lang_codeНетКод языка (см. /system/google-langs)
merge_mapНетУчитывать выдачу Google maps. 0 – не учитывать, 1 – учитывать, 2 – учитывать и отображать отдельно. Только для Google
business_nameНетНазвание бизнеса. Для выдачи Google Maps. Только для Google
phoneНетТелефон компании. Для выдачи Google Maps
paid_resultsНетОтслеживать позиции в Google Adwords (1 – да, 0 – нет)
featured_snippetНетУчитывать блоки с ответами (1 – учитывать, 0 – нет). Только для Google

Результат

В случае успеха сервер вернет HTTP код 201 и site_engine_id добавленной поисковой системы.

Ошибки

HTTP-кодСообщение об ошибке
404Unknown search_engine_id

Изменение поисковой системы в проекте

Метод позволяет добавить новые поисковые системы в проект.

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

Title of the code block
Copy
PUT https://api4.seranking.com/sites/{site_id}/search-engines/{site_engine_id}
{
"region_name": null,
"lang_code": "ru",
"merge_map": 0,
"business_name": null,
"phone": null,
"paid_results": 0,
"featured_snippet": 0
}

Параметры

Cм. добавление поисковой системы.

Результат

В случае успеха сервер возвращает HTTP 200 OK.

Удаление поисковой системы в проекте

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

Title of the code block
Copy
DELETE https://api4.seranking.com/sites/{site_id}/search-engines/{site_engine_id}

Результат

В случае успеха сервер возвращает HTTP 204.

Список ключевых слов сайта

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

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/keywords?site_engine_id=NNN

Параметры запроса

search_engine_idНеобязательный параметр.
ID поисковой системы (см. GET /system/search-engines)
Если он передан, то возвращается дата first_check_date

Результат

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

ИмяОписание
idУникальный идентификатор запроса
nameКлючевое слово
group_idID группы запросов
linkЦелевой URL
first_check_dateДата первой проверки запроса в поисковой системе site_engine_id если она указана в запросе
tagsСписок ID тегов
site_engine_idsСписок ID поисковых систем

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

Title of the code block
Copy
[
{
"id": "1",
"name": "key1",
"group_id": "2",
"link": null,
"first_check_date": "2015-02-17",
"tags": [
"11",
"12"
]
},
{
"id": "2",
"name": "key2",
"group_id": "2",
"link": "https://mysite.com/",
"first_check_date": null,
"tags": []
},
...
]

Список тегов в проекте

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/keywords-tags

Результат

Сервер возвращает массив тегов.

ИмяОписание
idУникальный идентификатор тега (ID)
nameНазвание тега
colorЦвет тега (в hex формате)

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

Title of the code block
Copy
[
{
"id": 3686,
"name": "Ad",
"color": "64b5f6"
},
{
"id": 3695,
"name": "Rates",
"color": "FFD53B"
}
]

Сводная статистика

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

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/stat

Результат

ИмяОписание
site_idУникальный идентификатор сайта (ID)
today_avgСредняя позиция за последнюю дату снятия позиций (сегодня)
yesterday_avgСредняя позиция за предыдущую дату снятия позиций (вчера)
total_upСколько позиций поднялось в выдаче
total_downСколько позиций опустилось в выдаче
processТекущий процент обработки позиций сайта
top5Запросов в ТОП 5
top10Запросов в ТОП 10
top30Запросов в ТОП 30
visibilityПрогноз трафика
visibility_percentВидимость в %
index_googleКоличество страниц в индексе Google

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

Title of the code block
Copy
{
"site_id": 123,
"name": "site1.com",
"group_id": null,
"title": "my site",
"today_avg": 123,
"yesterday_avg": 111,
"total_up": 0,
"total_down": 5,
"process": "99.9",
"top5" : 1,
"top10" : 2,
"top30" : 3,
"visibility" : 2,
"visibility_percent" : 30.0,
"da" : 4,
"index_google" : 200,
"index_x" : null,
}

Статистика по ключевым словам

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

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/positions?date_from=2018-01-01&date_to=2018-01-07&site_engine_id=1&with_landing_pages=1&with_serp_features=1&historical=1

Параметры

Query-параметры. Все параметры не обязательны.

ИмяТипОписание
date_fromyyyy-mm-ddДата начала периода (по умолчанию – сегодня минус неделя)
date_toyyyy-mm-ddДата конца периода (по умолчанию – сегодня)
site_engine_id ID поисковой системы. Если не указано, вернёт данные по всем поисковым системам
in_top Фильтр по позиции. Напр. in_top=10 вернёт данные только о запросах, входящих в ТОП 10 на момент последней проверки в выбранном периоде.
with_landing_pages Информация url страницы в поисковой выдаче
with_serp_features Специальные элементы поисковой выдачи, найденные в результатах поиска по ключевому слову
historicalчисло (1 или 0)Добавляет в ответ дополнительную информацию по позициям в определенные даты: первая проверка, 6 месяцев назад, 3 месяца назад, 1 месяц назад, 7 дней назад, вчера, сегодня.

Результат

В случае успеха сервер возвращает массив из всех (или указанной) поисковых систем проекта, содержащий статистику по ключевым словам за указанный период.Возвращает максимум 100000 записей позиций (positions). Если в проекте большое количество ключевых слов, желательно указывать ID поисковой системы и период проверки.

ИмяОписание
idУникальный идентификатор запроса
positionМассив с элементами
dateДата
changeИзменение позиции по сравнению с пред. датой (может быть отрицательное)
posТекущая позиция
priceЦена, рассчитанная из настроек финансового отчёта
is_mapУказывает, где найдена позиция, принимает значение 0 для органической выдачи, 1 – для блока с картами
map_positionПозиция в блоке с картами, при включенной опции “Отображать позиции для органической и выдачи карт отдельно” (merge_map = 2)
paid_positionПозиция в платной выдаче Google
landing_pagesМассив с элементами:
– date – дата в формате yyyy-mm-dd
– url – url страницы в поисковой выдаче по ключевому слову
featuresМассив с элементами поиска. Если значение true – в элементе поиска найдена ссылка на сайт проекта
volumeЧастотность
competitionКонкуренция
suggested_bidЦена за один клик
keiИндекс эффективности ключевого слова
resultsКоличество результатов по данному запросу в Google
total_sumЦена за запросы, рассчитанная из настроек финансового отчёта

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

Title of the code block
Copy
[
{
"site_engine_id": 1,
"keywords": [
{
"id": "12",
"positions": [
{
"date": "2017-12-19",
"pos": 18,
"change": 0,
"price": 0,
"is_map": 0,
"map_position": 0,
"paid_position": 0
}
],
"volume": 390,
"competition": 3,
"suggested_bid": 1,
"kei": 1,
"resultsi": 100,
"total_sum": 0,
"landing_pages": [
{
"url": "https://domain.com/page.html",
"date": "2017-12-14"
}
],
"features": {
"tads": true,
"knowledge_graph": true,
"images": true,
"sitelinks": true,
"reviews": false
},
},
...
]
}
]

Ошибки

HTTP-кодСообщение об ошибке
400Invalid site_engine_id

Графики количества объявлений

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

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

Title of the code block
Copy
 GET https://api4.seranking.com/sites/{site_id}/ads?date_from=2020-05-20&date_to=2020-05-21&site_engine_ids[]=1&site_engine_ids[]=2&keywords_ids[]=1&keywords_ids[]=1 

Параметры запроса

Query-параметры. Все параметры не обязательны.

ИмяТипОписание
date_fromyyyy-mm-ddДата начала периода (по умолчанию – сегодня минус неделя).
date_toyyyy-mm-ddДата конца периода (по умолчанию – сегодня).
site_engine_idsФильтр по ID поисковых систем сайта.
Если не указано, вернет данные по всем поисковым системам.
keywords_idsФильтр по ID ключевых слов.
Если не указано, вернет данные по всем ключевым словам.

Результат

В случае успеха сервер возвращает массив данных из всех (или указанных) поисковых систем проекта. В этом массиве указаны данные по количеству верхних и нижних рекламных объявлений в поисковой выдаче по всем (или выбранным) ключевым словам по датам в указанном периоде.

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

ИмяОписание
site_engine_idID поисковой системы
keywordsМассив ключевых слов с данными по количеству объявлений
idID ключевого слова
adsМассив с данными по количеству объявлений по датам
dateДата
tabsКоличество верхних объявлений
badsКоличество нижних объявлений

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

Title of the code block
Copy
[{
"site_engine_id": 1,
"keywords": [
{
"id": 1,
"ads": [
{
"date": "2020-05-20",
"tads": 2,
"bads": 3
},
{
"date": "2020-05-21",
"tads": 3,
"bads": 2
},
]
},
{
"id": 2,
"ads": [
{
"date": "2020-05-20",
"tads": 0,
"bads": 0
},
{
"date": "2020-05-21",
"tads": 0,
"bads": 1
},
]
},
]
},
{
"site_engine_id": 2,
"keywords": [
{
"id": 1,
"ads": [
{
"date": "2020-05-20",
"tads": 1,
"bads": 1
},
{
"date": "2020-05-21",
"tads": 2,
"bads": 2
},
]
},
{
"id": 2,
"ads": [
{
"date": "2020-05-20",
"tads": 0,
"bads": 2
},
{
"date": "2020-05-21",
"tads": 5,
"bads": 1
},
]
},
]
}]

Графики позиций

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/chart?date_from=2019-09-09&date_to=2019-09-11&type=top10_percent&group_id=1191&keywords_ids[]=17075&tags_ids[]=1&site_engine_id=1061

Параметры запроса

ИмяОбязательныйОписание
date_fromНетНачало периода. 7 дней назад, если не указано.
date_toНетКонец периода. Текущая дата, если не указано.
typeНетТип графика. Если не указано avg_pos.
group_idНетID группы ключевых слов.
keywords_ids[]НетФильтр по ID ключевых слов.
tags_ids[]НетФильтр по ID тегов ключевых слов.
site_engine_idНетФильтр по ID поисковой системы в проекте.

Типы графиков:

  • avg_pos – средняя позиция
  • visibility – прогноз трафика
  • visibility_percent – видимость
  • top10 – количество ключей в ТОП 10
  • top10_percent – процент ключей в ТОП 10

Результат

Сервер вернет серии данных для каждой поисковой системы в проекте и для среднего значения показателя по всем поисковикам.

ИмяОписание
nameНазвание линии графика
dataДанные в виде пар дата – значение
typeТип линии графика: search_engine – данные поисковой системы, avg – среднее значение по всем.
search_engine_idID поисковой системы в проекте, только для type = avg.

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

Title of the code block
Copy
[
{
"name": "Google Mobile USA - Ср.",
"data": [
{
"date": "2019-09-09",
"value": "46"
},
{
"date": "2019-09-10",
"value": "22"
},
{
"date": "2019-09-11",
"value": "22"
}
],
"type": "search_engine",
"search_engine_id": 1540
},
{
"name": "Google USA - Ср.",
"data": [
{
"date": "2019-09-09",
"value": "38"
},
{
"date": "2019-09-10",
"value": "21"
},
{
"date": "2019-09-11",
"value": "20"
}
],
"type": "search_engine",
"search_engine_id": 200
},
{
"name": "Среднее по всем",
"data": [
{
"date": "2019-09-09",
"value": 42
},
{
"date": "2019-09-10",
"value": 22
},
{
"date": "2019-09-11",
"value": 21
}
],
"type": "avg",
"search_engine_id": null
}
]

Исторические даты

Метод возвращает список дат, необходимых для постройки графика исторических позиций. Даты соответствуют следующему списку: сегодня, вчера, 7 дней назад, 1 месяц назад, 3 месяца назад, 6 месяцев назад, первый день проверки. Если в указанную дату не было проверки позиций, то будет возвращена ближайшая дата проверки позиций.

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/historicalDates

Параметры запроса

ИмяОбязательныйОписание
site_engine_idНетID поисковой системы в проекте.
Если site_engine_id не указан – то ищет даты по всем поисковым системам.

Результат

В случае успеха сервер возвращает массив, содержащий список доступных дат. Массив может содержать следующие элементы: ‘current’, ‘day_ago’, ‘7days’, ’30days’, ’90days’, ‘180days’, ‘first’. В качестве значений будут переданы даты в формате YYYY-MM-DD.

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

Title of the code block
Copy
{
"current" : "2019-02-20",
"day_ago" : "2019-02-19",
"7days" : "2019-02-14",
}

Даты снятия позиций

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

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

Title of the code block
Copy
GET https://api4.seranking.com/sites/{site_id}/check-dates?date_from=2019-09-01&date_to=2019-09-30&site_engine_id=1061

Параметры запроса

ИмяОбязательныйОписание
date_fromНетНачало периода. 7 дней назад, если не указано.
date_toНетКонец периода. Текущая дата, если не указано.
site_engine_idНетИдентификатор поисковой системы в проекте.

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

Title of the code block
Copy
[
"2019-09-01",
"2019-09-02",
"2019-09-03",
"2019-09-04",
"2019-09-05",
"2019-09-06",
"2019-09-07",
"2019-09-08",
"2019-09-09",
"2019-09-10",
"2019-09-11"
]

Добавление запросов в проект

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

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

Title of the code block
Copy
POST https://api4.seranking.com/sites/{site_id}/keywords
[{
"keyword":"text",
"group_id":1,
"target_url": "https://site.com/",
"is_strict": 0,
"comment":"text",
"site_engine_ids": [20,21]
}]

Параметры в запросе

ИмяОбязательныйОписание
keywordДаКлючевое слово (запрос)
group_idНетID группы ключевых слов (если параметр не указан, будет использована группа по умолчанию)
target_urlНетЦелевая ссылка
is_strictНетПроверять позиции только для указанных целевых ссылок (0 или 1, по умолчанию – 0)
commentНетКомментарий
site_engine_idsНетМассив идентификаторов поисковых систем. Ключевое слово будет только в этих поисковиках.

Результат

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

ИмяОбязательныйОписание
addedДаКоличество успешно добавленных запросов в проект
idsНетМассив ID добавленных запросов

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

Title of the code block
Copy
{
"added": 3,
"ids": [
123,
456,
789
]
}

Ошибки

HTTP-кодСообщение об ошибке
400No keywords specified

Изменение ключевого слова в проекте

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

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

Title of the code block
Copy
PATCH https://api4.seranking.com/sites/{site_id}/keywords/{keyword_id}
{
"keyword":"text",
"target_url": "https://site.com/",
"comment":"text",
"site_engine_ids": [20,21]
}

Параметры в запросе

ИмяОписание
keyword Ключевое слово (запрос)
group_id ID группы ключевых слов для переноса ключевого слова в группу проекта (обязательно значение из списка ID групп ключевых слов проекта)
target_urlЦелевая ссылка
is_strict Проверять позиции только для указанных целевых ссылок (0 или 1, по умолчанию – 0)
commentКомментарий
site_engine_idsМассив идентификаторов поисковых систем. Ключевое слово будет только в этих поисковиках, из других удалиться.

Результат

В случае успеха сервер возвращает HTTP 200.

Ошибки

HTTP-код Сообщение об ошибке
400 Invalid or empty keyword data
403 Access denied (wrong site_id)
404 Unknown keyword (wrong keyword_id)

Добавление проекта

Метод позволяет добавить новый проект в аккаунт пользователя.

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

Title of the code block
Copy
POST https://api4.seranking.com/sites
{
"url":"https://test.site/",
"title":"seo site"
}

Параметры в запросе

ИмяОбязательныйОписание
urlДаURL сайта
titleДаНазвание проекта
match_modeДаТип проверки найденного урла: domain, subdomain, exact, path
check_freqНетПериодичность проверки позиций (‘check_daily’, ‘check_1in3’, ‘check_weekly’, ‘check_monthly’, ‘manual’), по умолчанию – check_daily
auto_reportsНетЕженедельный отчет? (0 или 1), по умолчанию – 1
site_group_idНетID группы, в которую будет добавлен новый проект
check_dayНетЕсли проверка еженедельная (check_weekly), то в этом параметре можно задать день недели.(от 1 – понедельник до 7 – воскресенье)
Если проверка check_monthly, то в параметре день месяца (1 – 31)
is_activeНетСтатус проекта: 1 – активен, 0 – отложен

Результат

В случае успеха сервер вернет HTTP код 201 и ID добавленного проекта в аккаунт.

ИмяОбязательныйОписание
site_idДаID проекта, добавленного в аккаунт

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

Title of the code block
Copy
{
"site_id": 507052
}

Изменение настроек проекта

Метод позволяет изменить/обновить настройки проекта.

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

Title of the code block
Copy
PUT https://api4.seranking.com/sites/{site_id}
{
"title":"new site title"
}

Параметры запроса

ИмяОписание
urlURL сайта
titleНазвание сайта
match_modeТип матчинга найденного урла в выдаче domain, subdomain, exect, path
check_freqПериодичность проверки позиций (‘check_daily’, ‘check_1in3’, ‘check_weekly’, ‘check_monthly’, ‘manual’), по умолчанию – check_daily
site_group_idID группы, в которую будет добавлен новый проект
check_dayЕсли проверка еженедельная (check_weekly), то в этом параметре можно задать день недели. (от 1 – понедельник до 7 – воскресенье). Если проверка check_monthly, то в параметре день месяца (1 – 31)
is_active1, 0

Результат

В случае успеха сервер вернет HTTP 200.

Удаление проекта

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

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

Title of the code block
Copy
DELETE https://api4.seranking.com/sites/{site_id}

Результат

В случае успеха сервер вернет HTTP 204.

Удаление ключевых слов

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

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

Title of the code block
Copy
DELETE https://api4.seranking.com/sites/{site_id}/keywords?keywords_ids[]=1&keywords_ids[]=2&keywords_ids[]=3

Query-параметры запроса

ИмяОбязательныйОписание
keywords_idsДаМассив ID удаляемых ключевых слов

Результат

В случае успеха сервер вернет HTTP 204.

Ошибки

HTTP-кодСообщение об ошибке
400No ids in request

Ручная установка позиции

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

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

Title of the code block
Copy
https://api4.seranking.com/sites/{site_id}/position/
{
"keyword_id": 1,
"date": "2018-01-01",
"position":100,
"site_engine_id": 1
}

Параметры запроса

ИмяОбязательныйТипОписание
keyword_idДа Уникальный идентификатор ключевого слова (см. GET https://api4.seranking.com/sites/{site_id}/keywords)
dateДаyyyy-mm-ddДата, на которую надо установить позиции
site_engine_isДа Уникальный идентификатор поисковой системы в проекте (см GET https://api4.seranking.com/sites/{site_id}/search-engines)
positionДа Позиция, от 0 до 200, 0 считается как “не найдено”

Результат

В случае успеха сервер вернет HTTP 200.

Ошибки

HTTP-кодСообщение об ошибке
400Invalid date
400Invalid keyword_id
400Unknown site_engine_id

Запуск проверки позиций

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

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

Title of the code block
Copy
POST https://api4.seranking.com/sites/{site_id}/recheck/
{
"keywords":[
{
"site_engine_id":1,
"keyword_id":2
}
]
}

Параметры

ИмяОбязательныйОписание
site_engine_idНетУникальный идентификатор поисковой системы проекта. Если этот параметр присутствует в API-запросе, то будет запущена проверка позиций только для этой поисковой системы.
keywordsДаМассив отдельных ключевых слов, для которых нужно запустить проверку позиций. Если массив пустой – выполняется проверка для всех ключевых слов. Для каждого ключевого слова указывается пара значений: site_engine_id (уникальный идентификатор поисковой системы проекта) и keyword_id (уникальный идентификатор ключевого слова).
Если этот параметр присутствует в API-запросе, то параметр site_engine_id игнорируется.

Результат

В случае успеха сервер возвращает HTTP 200 и количество ключевых слов, для которых была запущена проверка позиций.

ИмяОписание
totalКоличество ключевых слов, для которых запущена проверка позиций

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

Title of the code block
Copy
{
"total": 5
}

Ошибки

HTTP-кодСообщение об ошибке
400Unknown site_engine_id