Деякі функції обмежені.
Вхід Реєстрація

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

PPC фрази домену (ad_keywords)

З 31.12.2021 методи 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 - активний
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 (від 0 до 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 Python
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
}