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

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

Отчет по рекламе с указанным именем домена (ad_keywords)

ad_keywords — метод выполняет поиск рекламных объявлений по домену или ключу.

Пагинация

Для пагинации используйте  параметры:

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

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

{
"keyword": "nike air force 1",
"keyword_length": 4,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/w/air-force-1-shoes-5sj3yzy7ok?cp=15839883195_search_%7Cnike+air+force+1%7CGOOGLE%7C71700000042134106%7CAll_X_X_X_X-Device_X_AF1-General_Exact%7Ce%7Cc&gclid=EAIaIQobChMIj6f9r4Sx5QIVR3ZgCh360Qx6EAAYASAAEgL9FPD_BwE&gclsrc=aw.ds",
"title": "Nike Air Force 1 | Nike Official Site",
"text": "Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear.",
"position": 1,
"type": 1,
"cost": 0.71,
"concurrency": 100,
"found_results": 69,
"region_queries_count": 90500,
"region_queries_count_wide": 0,
"region_queries_count_last": 0,
"types": [
"related_search",
"also_asks",
"ads_top",
"shopping_top"
],
"geo_names": [

],
"_id": "24829288_1"
}

Example PHP Python
Request data:
Response data:
{
  "result": {
    "total": 4346,
    "hits": [
      {
        "keyword": "new jordans",
        "keyword_length": 2,
        "domain": "nike.com",
        "subdomain": "www.nike.com",
        "url": "https://www.nike.com/launch/t/air-jordan-34-blue-void/?cp=38436339870_search_%7Cnew+jordan+shoes%7CGOOGLE%7C71700000041131813%7CAll_X_X_X_X-Device_X_Jordan34_Exact%7Ce%7Cc&gclid=EAIaIQobChMImObKip3G5QIVBttkCh36PACYEAAYASAAEgJUdfD_BwE&gclsrc=aw.ds",
        "title": "Air Jordan XXXIV | The Newest Jordans",
        "text": "One Of the Lightest Air Jordans To Date.",
        "position": 1,
        "type": 1,
        "cost": 0.34,
        "concurrency": 100,
        "found_results": 2350000000,
        "region_queries_count": 201000,
        "region_queries_count_wide": 0,
        "region_queries_count_last": 0,
        "types": [
          "ads_top",
          "shopping_top",
          "also_asks",
          "video",
          "related_search"
        ],
        "geo_names": [
          
        ],
        "_id": "14996_1"
      },
      {
        "keyword": "nike air force 1",
        "keyword_length": 4,
        "domain": "nike.com",
        "subdomain": "www.nike.com",
        "url": "https://www.nike.com/w/air-force-1-shoes-5sj3yzy7ok?cp=15839883195_search_%7Cnike+air+force+1%7CGOOGLE%7C71700000042134106%7CAll_X_X_X_X-Device_X_AF1-General_Exact%7Ce%7Cc&gclid=EAIaIQobChMIj6f9r4Sx5QIVR3ZgCh360Qx6EAAYASAAEgL9FPD_BwE&gclsrc=aw.ds",
        "title": "Nike Air Force 1 | Nike Official Site",
        "text": "Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear.",
        "position": 1,
        "type": 1,
        "cost": 0.71,
        "concurrency": 100,
        "found_results": 69,
        "region_queries_count": 90500,
        "region_queries_count_wide": 0,
        "region_queries_count_last": 0,
        "types": [
          "related_search",
          "also_asks",
          "ads_top",
          "shopping_top"
        ],
        "geo_names": [
          
        ],
        "_id": "24829288_1"
      }
    ]
  },
  "status_msg": "OK",
  "status_code": 200,
  "left_lines": 947650
}
<?php
// This example works on serpstat-sdk only
// https://github.com/SerpstatGlobal/serpstat-sdk

require_once __DIR__ . '/../vendor/autoload.php';
// configure your application
$config = [
    'token' => '19666fc1ae1724da1d5ea2f3a99d5f5a',
];
$keywords = 'keywords';
// init client with your serpstat api token
$apiClient = new \Serpstat\Sdk\Core\ApiGuzzleHttpClient($config['token']);
// create instance of any api method class
// list of methods classes in folder src\Methods
$apiMethod = new \Serpstat\Sdk\Methods\AdKeywordsMethod(
    $keywords,
    \Serpstat\Sdk\Interfaces\IApiClient::SE_GOOGLE_RU
);
try {
    // try call api method
    $response = $apiClient->call($apiMethod);
} catch (\Exception $e) {
    // catch api error
    $response = $e->getMessage();
}
"import codecs
import json
import pprint
import urllib.request as urlrequest
from urllib.parse import urlencode

host = 'http://api.serpstat.com/v3'

method = 'ad_keywords'
params = {
    'query': 'example.com',  # string for get info
    'se': 'g_us',  # string search engine
    'token': 'ijmiom4f5m34905g03um8342dm04923lre3w',  # string personal token
}

api_url = ""{host}/{method}?{params}"".format(
    host=host,
    method=method,
    params=urlencode(params)
)

try:
    json_data = urlrequest.urlopen(api_url).read()
except Exception as e0:
    print(""API request error: {error}"".format(error=e0))

data = json.loads(json_data)
pprint.pprint(data)"

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

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

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

Или 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
Сообщение
необязательно

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

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

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