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

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

Рекламные объявления по ключевой фразе V4 (SerpstatKeywordProcedure.getAdKeywords)

SerpstatKeywordProcedure.getAdKeywords  метод выполняет поиск рекламных объявлений по ключевой фразе.

Параметры запроса:

Название Описание Тип Опциональный Значение по умолчанию Варианты значений
keyword Фраза, для которой будет происходить поиск string нет   купить iphone
se Идентификатор поисковой базы, по которой будет проходить поиск string нет   g_ua
domains Список доменов, массив array да [] ["allo.ua", "citrus.ua"]
minusKeywords Список минус-слов при поиске, массив array да [] ["алло", "ало"]
filters Условия фильтрации json object да

{"queries_from": 10} {"queries_to": 10}

sort

Порядок сортировки результатов в формате:

{{{field}}: {{order}}}

field - поле, по которому нужно выполнить сортировку

order - направление сортировки (asc — по возрастанию, desc — по убыванию)
json object да {"position": "asc", "region_queries_count":"desc"} {"cost": "asc"}
page Номер страницы в ответе int да 1 5
size Количество результатов на страницу в ответе int да 100 50-1000


Сортировка результатов возможна по следующим поля:

Параметр
keyword_length
position
type
cost
concurrency
found_results
region_queries_count
region_queries_count_wide
region_queries_count_last


Для фильтрации результатов используйте следующие параметры:

Параметр Описание Возможные значения 
queries_from Минимальная частотность в месяц  0-100000000
queries_to Максимальная частотность в месяц  0-100000000
position_from Минимальная позиция  1-100
position_to Максимальная позиция  1-100
cost_from Минимальная стоимость за клик  0-200
cost_to Максимальная стоимость за клик  0-200
concurrency_from Минимальное значение конкуренции ключевой фразы в PPC  1-100
concurrency_to Максимальное значение конкуренции ключевой фразы в PPC  1-100
results_from Минимальное значение результатов  0-100000000
results_to Максимальное значение результатов  0-100000000
length_from Минимальное значение длины фразы  0-100000000
length_to Максимальное значение длины фразы  0-100000000


Метрики ответа:

Метрики Описание
result Инкапсулирует в себе ответ
total Количество найденных объявлений, которые отображаются по запросам, содержащие искомую фразу
region_queries_count Частотность ключевой фразы в выбранном регионе
region_queries_count_wide Частотность ключевой фразы в широком соответствии
region_queries_count_last Частотность ключевой фразы за последний месяц
domain Домен
keyword_length Количество слов, разделенных пробелом в ключевой фразе
keyword Ключевая фраза по которой отображается объявление
title Заголовок объявления
url Url объявления
text Текст объявления
found_results Количество найденных результатов по ключевой фразе ""keyword"
cost Цена за клик, $
concurrency Конкурентность в контекстной рекламе (0-100)
position Позиции объявлений в контекстной рекламе
date Дата актуализации объявления
subdomain Поддомен
type Место размещения объявления в SERP (1. Над; 2. Под; 3. Справа)
types Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое )
geo_names Список топонимов в масиве, если топоним присутствует в ключевой фразе. Если нет — масив пустой.
left_lines Количество оставшихся API строк


Лимиты:
 количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
"keyword": "купить ноутбуки",
"keyword_length": 2,
"domain": "foxtrot.com.ua",
"subdomain": "www.foxtrot.com.ua",
"url": "https://www.foxtrot.com.ua/ru/shop/noutbuki.html",
"title": "Купить Ноутбуки в Фокстроте | В наличии. Выгодные цены",
"text": "Заказывайте в интернете - забирайте в удобное время в магазине Фокстрот! Кредит до 24 месяцев. Цена проверена. Официальная гарантия. Акции каждый день. Места: Киев, Харьков.",
"position": 1,
"type": 1,
"cost": 0.120833,
"concurrency": 100,
"found_results": 52700000,
"region_queries_count": 27100,
"region_queries_count_wide": 74000,
"types": [
  "ads_top",
  "related_search"
],
"geo_names": [
  
],
}

Example
Request data:
{
    "id": {{any_num_or_string}},
    "method": "SerpstatKeywordProcedure.getAdKeywords",
    "params": {
        "se": {{search_engine}},
        "keyword": {{keyword}},
        (optional) "domains": [{{domian1}}],
        (optional) "minusKeywords": [{{keyword1}}],
        (optional) "filters": [{{field_from}}: {{value}}, {{field_to}}: {{value}}],
        (optional) "sort" : [{{filed}}:{{"asc"|"desc"}}],
        (optional) "page": {{page}},
        (optional) "size": {{size}}
    }
}
Response data:
{
  "id": {{any_num_or_string}},
  "result": {
    "data": [
      {
        "keyword": "купить ноутбуки",
        "keyword_length": 2,
        "domain": "foxtrot.com.ua",
        "subdomain": "www.foxtrot.com.ua",
        "url": "https://www.foxtrot.com.ua/ru/shop/noutbuki.html",
        "title": "Купить Ноутбуки в Фокстроте | В наличии. Выгодные цены",
        "text": "Заказывайте в интернете - забирайте в удобное время в магазине Фокстрот! Кредит до 24 месяцев. Цена проверена. Официальная гарантия. Акции каждый день. Места: Киев, Харьков.",
        "position": 1,
        "type": 1,
        "cost": 0.120833,
        "concurrency": 100,
        "found_results": 52700000,
        "region_queries_count": 27100,
        "region_queries_count_wide": 74000,
        "types": [
          "ads_top",
          "related_search"
        ],
        "geo_names": [
          
        ],
      },
      
    ],
    "summary_info": {
      "page": 1,
      "total": 1052843,
      "left_lines": 9999900
    }
  }
}

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

Войти Регистрация

Вы исчерпали лимит запросов.

Или email
Забыли пароль?
Или email
Optional
Back To Login

Не волнуйтесь! Напишите свой электронный адрес и мы пришлем вам новый пароль.

Вы уверены?

Awesome!

To complete your registration you need to enter your phone number

Назад

Мы отправили код подтверждения на ваш номер телефона

Your phone Resend code Осталось запросов

Что-то пошло не так.

Свяжитесь с нашей службой поддержки
Или подтвердите регистрацию с помощью Телеграм бота Перейдите по этой ссылке
Выберите один из проектов

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Увеличить лимиты

Улучшить тариф

Экспорт недоступен для вашего тарифного плана. Вам необходимо улучшить свой тариф до Lite или выше, чтобы получить доступ к инструменту Подробнее

Зарегистрироваться

Спасибо, мы сохранили ваши новые настройки рассылок.

Пригласить
Просмотр Редактирование

E-mail
Сообщение
необязательно
E-mail
Сообщение
необязательно

У вас закончились лимиты

Вы достигли лимита на количество созданных проектов и больше не можете создавать новые проекты. Увеличьте лимиты или удалите существующие проекты.

Я хочу больше лимитов
Открыть чат технической поддержки