SerpWatch
Меню

Упоминания бренда

Метод API SerpWatch: где упоминают бренд проекта, есть ли на странице ссылка на сайт и что найдено впервые.

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

Возвращает упоминания из раздела «Упоминания бренда»: страницы из выдачи Яндекса по фразам бренда и результат проверки ссылки на сайт. Поиск идёт раз в неделю на тарифах «Про» и «Агентство». Упоминания без ссылки — список площадок, которых можно попросить поставить ссылку.

Параметры

ПараметрГдеЧто значит
idв путиid проекта
filterнеобязательноall — все видимые, unlinked — без ссылки, new — новые, linked — со ссылкой, hidden — скрытые

Ответ

ПолеЧто значит
idid упоминания
urlстраница с упоминанием
domainдомен страницы
titleзаголовок из выдачи
snippetфрагмент текста из выдачи
phraseфраза бренда, по которой нашли
statuslinked — со ссылкой, unlinked — без ссылки, error — страница не открылась, pending — ещё не проверена
relfollow или 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 запросов в минуту — в разделе ошибки и лимиты.

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

  • Список площадок для писем «поставьте, пожалуйста, ссылку»
  • Отчёт клиенту о том, где о нём пишут