Упоминания бренда
Метод API SerpWatch: где упоминают бренд проекта, есть ли на странице ссылка на сайт и что найдено впервые.
GET/api/v1/projects/{id}/mentions
Возвращает упоминания из раздела «Упоминания бренда»: страницы из выдачи Яндекса по фразам бренда и результат проверки ссылки на сайт. Поиск идёт раз в неделю на тарифах «Про» и «Агентство». Упоминания без ссылки — список площадок, которых можно попросить поставить ссылку.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
filter | необязательно | all — все видимые, unlinked — без ссылки, new — новые, linked — со ссылкой, hidden — скрытые |
Ответ
| Поле | Что значит |
|---|---|
id | id упоминания |
url | страница с упоминанием |
domain | домен страницы |
title | заголовок из выдачи |
snippet | фрагмент текста из выдачи |
phrase | фраза бренда, по которой нашли |
status | linked — со ссылкой, unlinked — без ссылки, error — страница не открылась, pending — ещё не проверена |
rel | follow или nofollow, sponsored, ugc — если ссылка есть, иначе null |
target_url | куда ведёт ссылка или null |
anchor | текст ссылки или null |
is_new | найдено впервые при последнем поиске |
hidden | скрыто пользователем |
first_seen | когда нашли впервые |
last_seen | последний раз в выдаче |
checked_at | когда открывали страницу |
[
{
"id": 14,
"url": "https://autoforum.ru/topic/77",
"domain": "autoforum.ru",
"title": "Где отремонтировать подвеску",
"snippet": "…делал в Ultra Auto, всё быстро…",
"phrase": "Ultra Auto",
"status": "unlinked",
"rel": null,
"target_url": null,
"anchor": null,
"is_new": true,
"hidden": false,
"first_seen": "2026-10-12T03:20:41",
"last_seen": "2026-10-12T03:20:41",
"checked_at": "2026-10-12T03:21:02"
}
]
Примеры
curl
curl -H "Authorization: Bearer sw_ваш_токен" \ "https://serpwatch.ru/api/v1/projects/12/mentions"
Python
import requests
r = requests.get("https://serpwatch.ru/api/v1/projects/12/mentions",
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
400 — неизвестный фильтр. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Список площадок для писем «поставьте, пожалуйста, ссылку»
- Отчёт клиенту о том, где о нём пишут