Отчет по рекламе с указанным именем домена (ad_keywords)
Метод ad_keywords выполняет поиск ключевых слов в платной выдаче и рекламных объявлений по домену. Аналогичен отчету Анализ домена — PPC-анализ — Ключевые слова.
Общие параметры запроса и инструкция по использованию Serpstat API
Для пагинации используйте параметры:
page_size: количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page: номер страницы (по умолчанию 1-я страница).
Для фильтрации результатов используйте следующие параметры:
| Параметр | Описание | Возможные значения |
| position_from | Минимальная позиция ключевого слова | 1-100 |
| position_to | Максимальная позиция ключевого слова | 1-100 |
| queries_from | Минимальное количество запросов в месяц | 0-100000000 |
| queries_to | Максимальное количество запросов в месяц | 0-100000000 |
| cost_from | Минимальная стоимость за клик | 0-200 |
| cost_to | Максимальная стоимость за клик | 0-200 |
| concurrency_from | Минимальное значение конкуренции | 1-100 |
| concurrency_to | Максимальное значение конкуренции | 1-100 |
| right_spelling | Фильтрация по фразам с неправильным написанием | not_contains - содержит фразы с неправильным написанием; contains - не содержит фразы с неправильным написанием |
Для сортировки результата используйте параметры:
sort: поле, по которому нужно выполнить сортировку.
order: направление сортировки (asc — по возрастанию, desc — по убыванию).
| Параметры ответа | |
| Параметр | Описание |
| result | Содержит в себе ответ |
| total | Количество найденных ключевых фраз в РРС по домену |
|
hits
|
Содержит в себе ответ |
| keyword | Ключевая фраза, по которой отображается объявление |
| keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
| domain | Домен |
| subdomain | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
| url | Url объявления, который отображается в поисковой выдаче по данному запросу |
| title | Заголовок объявления |
| text | Текст объявления, который отображается в поисковой выдаче по данному запросу |
| position | Позиции объявлений в контекстной рекламе |
| type | Место размещения объявления в SERP (1 - над; 2 - под; 3 - справа) |
| cost | Цена за клик, $ |
| concurrency | Конкурентность в контекстной рекламе (0-100%) |
| found_results | Количество найденных результатов по ключевой фразе |
| region_queries_count | Частотность ключевой фразы в выбранном регионе |
| region_queries_count_last | Частотность ключевой фразы за последний месяц |
| types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое) |
| geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
| difficulty | Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100) |
| status_msg | Ответ: «OK» или «Error», сообщает об удачном или неудачном запросе |
| status_code | Код ответа «200» — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
| left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "nike koshes",
"keyword_length": 2,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/gb/w/sale-3yaep",
"title": "Nike.com Official Clearance - Stock Up On Clearance Shoes",
"text": "Nike Clearance Gear Gives You A Chance To Add Top-Flight Products To Your Collection. Find The Items That Match Your Style And Complete Your Look. Shop Clearance Now. Medical Workers Save 10% Shop With Nike Experts. Free Shipping for Members.",
"position": 1,
"type": "1",
"cost": 0.29999999999999999,
"concurrency": 100,
"found_results": 64,
"region_queries_count": 1000000,
"region_queries_count_last": 10,
"types": [
"ads_top"
],
"geo_names": [],
"difficulty": null,
"_id": "4754893372_1"
},Request data:
Response data:
{
"result": {
"total": 1537,
"hits": [
{
"keyword": "nike koshes",
"keyword_length": 2,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/gb/w/sale-3yaep",
"title": "Nike.com Official Clearance - Stock Up On Clearance Shoes",
"text": "Nike Clearance Gear Gives You A Chance To Add Top-Flight Products To Your Collection. Find The Items That Match Your Style And Complete Your Look. Shop Clearance Now. Medical Workers Save 10% Shop With Nike Experts. Free Shipping for Members.",
"position": 1,
"type": "1",
"cost": 0.29999999999999999,
"concurrency": 100,
"found_results": 64,
"region_queries_count": 1000000,
"region_queries_count_last": 10,
"types": [
"ads_top"
],
"geo_names": [],
"difficulty": null,
"_id": "4754893372_1"
},
{
"keyword": "nicke air force",
"keyword_length": 3,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/w",
"title": "Nike Air Force 1 - Nike Official Site",
"text": "An Iconic Shoe Designed To Keep You Comfortable On & Off The Court. Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear. Air Cushioning. Free Shipping for Members. Leather Upper. Models: Low, High, Sage, Jester, Shadow, Gore-Tex, Retro, Utility.",
"position": 1,
"type": "1",
"cost": 0.39000000000000001,
"concurrency": 100,
"found_results": 78,
"region_queries_count": 823000,
"region_queries_count_last": 823000,
"types": [
"ads_top",
"shopping_top",
"also_asks"
],
"geo_names": [],
"difficulty": null,
"modified_date": "2021-04-22",
"_id": "693985318_1"
}
]
},
"status_msg": "OK",
"status_code": 200,
"left_lines": 998017
}