Отчет по рекламе с указанным именем домена (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"
},

Example

Request data:

api.serpstat.com/v3/ad_keywords?query=nike.com&token=XXX&se=g_us

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
}