Деякі функції обмежені. Зареєструйтесь безкоштовно

Рекламний звіт (ad_keywords)

З 01.03.2022 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод ad_keywords виконує пошук ключових слів в платній видачі та рекламних оголошень по ключовому слову. Аналогічний до звіту Аналіз ключових слів — РРС-аналіз — Ключові слова.

Загальні параметри запиту та інструкція щодо використання 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
url Фільтрація по url  string
keywords Фільтрація по словам (список слів через кому)  string
minus_keywords Фільтрація по мінус словам (список слів через кому)  string
exact_url Шукати тільки точне входження url  1 - активний
pm_url Шукати тільки часткове входження url  1 - активний


Для сортування результату можно використовувати параметри:
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 (від 0 до 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
}

Поділіться статтею з вашими друзями

Ви впевнені?

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

Наш фахівець зв'яжеться з вами і за підсумком запропонує відповідний варіант, який може включати персональну демонстрацію, пробний період, навчальні статті та записи вебінарів, консультацію фахівця, а також комфортні умови для старту використання Serpstat.

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Дякуємо, ми зберегли ваші нові налаштування розсилок.

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

Відкрити чат технічної підтримки