Некоторые функции ограничены.
Вход Регистрация

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

Отчет по рекламе (ad_keywords)

С 31.12.2021 методы API v3 будут недоступны. Воспользуйтесь аналогичным методом API v4.

Метод ad_keywords выполняет поиск ключевых слов в платной выдаче и рекламных объявлений по ключевой фразе. Аналогичен отчету Анализ ключевых фраз - РРC-анализ - Ключевые слова.

Общие параметры запроса и инструкция по использованию 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

Для сортировки результата используйте параметры:
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 Список топонимов в маcсиве, если топоним присутствует в ключевой фразе. Если нет — масcив пустой.
difficulty Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
status_msg Ответ: «OK» или «Error», сообщает об удачном или неудачном запросе
status_code Код ответа «200» — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
    "keyword": "iphone see",
    "keyword_id": 50423945,
    "keyword_length": 2,
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "url": "https://www.apple.com/iphone-se/",
    "url_crc": 818000116,
    "title": "iPhone SE - Apple Official Site",
    "text": "The A13 Bionic chip is built for speed. It’s just what you’ve been waiting for.",
    "crc": -1550457144,
    "position": 1,
    "type": "1",
    "cost": 1.54,
    "concurrency": 100,
    "found_results": 2920000000,
    "region_queries_count": 1500000,
    "region_queries_count_last": 1830000,
    "types": [
        "top_stories",
        "also_asks",
        "kn_graph_carousel_list",
        "shopping_top",
        "ads_top"
        ],
    "geo_names": [],
    "difficulty": 73.432686121561062,
    "modified_date": "2021-07-14",
    "_id": "50423945_1"
},

Example
Request data:

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

Response data:
{
    "result": {
        "total": 10071,
        "hits": [
            {
                "keyword": "iphone see",
                "keyword_id": 50423945,
                "keyword_length": 2,
                "domain": "apple.com",
                "subdomain": "www.apple.com",
                "url": "https://www.apple.com/iphone-se/",
                "url_crc": 818000116,
                "title": "iPhone SE - Apple Official Site",
                "text": "The A13 Bionic chip is built for speed. It’s just what you’ve been waiting for.",
                "crc": -1550457144,
                "position": 1,
                "type": "1",
                "cost": 1.54,
                "concurrency": 100,
                "found_results": 2920000000,
                "region_queries_count": 1500000,
                "region_queries_count_last": 1830000,
                "types": [
                    "top_stories",
                    "also_asks",
                    "kn_graph_carousel_list",
                    "shopping_top",
                    "ads_top"
                ],
                "geo_names": [],
                "difficulty": 73.432686121561062,
                "modified_date": "2021-07-14",
                "_id": "50423945_1"
            },
            {
                "keyword": "iphone 12 pro max",
                "keyword_id": 11357316353,
                "keyword_length": 4,
                "domain": "verizon.com",
                "subdomain": "www.verizon.com",
                "url": "https://www.verizon.com/smartphones/apple-iphone-12-pro-max/",
                "url_crc": -1435350892,
                "title": "Verizon: iPhone 12 Pro Max - Up To $700 Off w/ Trade In",
                "text": "Up to $700 w/ select trade-in & select Unlimited plans. Plus $300 to switch. Terms apply. iPhone 12 Pro Max. Pro camera system for next-level low-light photography. Buy yours today. 5G Goes Pro. 6.7\" XDR Display. Pro Camera System. Night Mode Camera.",
                "crc": 1717675613,
                "position": 1,
                "type": "1",
                "cost": 1.7,
                "concurrency": 100,
                "found_results": 958000000,
                "region_queries_count": 1500000,
                "region_queries_count_last": 60500,
                "types": [
                    "shopping_rhs",
                    "kn_graph_carousel_list",
                    "also_asks",
                    "ads_top",
                    "top_stories"
                ],
                "geo_names": [],
                "difficulty": 48.050073552953251,
                "_id": "11357316353_1"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999155
}