SerpWatch
Меню

Брендовый трафик

Метод API SerpWatch: брендовый и небрендовый трафик — клики и показы по запросам с названием компании и без него.

GET/api/v1/projects/{id}/brand

Делит запросы проекта на брендовые и небрендовые и складывает их клики и показы из Вебмастера или Search Console за период, плюс те же суммы за предыдущий такой же период и клики по неделям за 13 недель. Брендовый запрос — в нём есть любое брендовое слово из настройки проекта (по умолчанию слова берутся из домена и названия проекта); точечные исключения из настройки важнее слов. Новых запросов к поисковикам метод не делает. status = noconn, если поисковик не подключён, nodata — если данных нет.

Параметры

ПараметрГдеЧто значит
idв путиid проекта
daysнеобязательнопериод: 7, 28 (по умолчанию) или 90
engineнеобязательноyandex или google; по умолчанию первый подключённый
region_idнеобязательноid региона проекта

Ответ

ПолеЧто значит
statusok, nodata или noconn
engine, region_id, days, date_from, date_toчто посчитано
brand_wordsбрендовые слова; auto_words = true — подобраны автоматически
exceptionsbrand[] — запросы, которые всегда бренд; non_brand[] — никогда не бренд
non_brand, brandclicks, impressions, queries, prev_clicks, prev_impressions, clicks_change — изменение кликов к прошлому периоду, %, или null
non_brand_clicks_share, non_brand_impressions_shareдоля небрендового трафика, %
weeks[]week_start, brand_clicks, non_brand_clicks
top_non_brand[], top_brand[]keyword_id, keyword, clicks, impressions, position, exception — решено исключением, а не словами
{
  "status": "ok",
  "engine": "yandex",
  "region_id": 1,
  "days": 28,
  "date_from": "2026-09-13",
  "date_to": "2026-10-10",
  "brand_words": [
    "ultraauto",
    "ультраауто",
    "ультра авто"
  ],
  "auto_words": true,
  "exceptions": {
    "brand": [],
    "non_brand": [
      "авто ультра звук"
    ]
  },
  "non_brand": {
    "clicks": 1840,
    "impressions": 61200,
    "queries": 212,
    "prev_clicks": 1610,
    "prev_impressions": 55400,
    "clicks_change": 14
  },
  "brand": {
    "clicks": 960,
    "impressions": 3100,
    "queries": 9,
    "prev_clicks": 990,
    "prev_impressions": 3240,
    "clicks_change": -3
  },
  "non_brand_clicks_share": 65.7,
  "non_brand_impressions_share": 95.2,
  "weeks": [
    {
      "week_start": "2026-10-04",
      "brand_clicks": 236,
      "non_brand_clicks": 471
    }
  ],
  "top_non_brand": [
    {
      "keyword_id": 12,
      "keyword": "замена масла",
      "clicks": 310,
      "impressions": 4200,
      "position": 2.4,
      "exception": false
    }
  ],
  "top_brand": [
    {
      "keyword_id": 3,
      "keyword": "ультра авто отзывы",
      "clicks": 140,
      "impressions": 380,
      "position": 1.1,
      "exception": false
    }
  ]
}

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects/12/brand"

Python

import requests

r = requests.get("https://serpwatch.ru/api/v1/projects/12/brand",
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

400 — неверный days или engine; 404 — проект или регион не найден. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

Для чего пригодится

  • Честный KPI подрядчика по SEO: рост небрендовых кликов
  • Дашборд: брендовый спрос рядом с рекламой