Брендовый трафик
Метод 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 региона проекта |
Ответ
| Поле | Что значит |
|---|---|
status | ok, nodata или noconn |
engine, region_id, days, date_from, date_to | что посчитано |
brand_words | брендовые слова; auto_words = true — подобраны автоматически |
exceptions | brand[] — запросы, которые всегда бренд; non_brand[] — никогда не бренд |
non_brand, brand | clicks, 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: рост небрендовых кликов
- Дашборд: брендовый спрос рядом с рекламой