Brand Mentions
Упоминание бренда — это общедоступная веб-страница, в тексте которой встречается бренд: обзор, новостная статья, ветка форума или карточка товара, вместе с фрагментом вокруг названия, автором, языком, страной и датой публикации. С оценкой тональности и ранжированием по авторитетности страницы и домена такие страницы показывают, где говорят о бренде, в какую сторону склоняется обсуждение и какие источники весомее, что служит основой для мониторинга репутации, оценки эффективности PR и анализа конкурентов.
Возможности Brand Mentions API
- Поиск по ключевому слову и точное совпадениеquery принимает бренд, продукт или тему длиной до 100 символов; фраза в двойных кавычках ищется дословно.
- Фильтр по типу сайтаcontent_type ограничивает результаты типом news, blogs, message-boards, ecommerce или organization, а page_types указывает тип каждого результата.
- Тональность фрагментаsentiment делит фрагмент на позитивную, негативную и нейтральную доли с суммой 1, а emotions оценивает радость, любовь, веселье, желание поделиться, грусть и гнев от 0 до 1.
- Авторитетность и качествоdomain_rank и page_rank измеряют авторитетность от 0 до 1000, а spam_score и content_quality_score помогают отсеять малосодержательные и спамные страницы.
- Контекст каждого упоминанияtitle, фрагмент в text, author_name, language, country, published_at при наличии и fetched_at показывают, когда и где появилось упоминание.
- До 1000 страниц за запросresults_limit принимает значения от 1 до 1000, чтобы за один проход оценить присутствие бренда в интернете.
Параметры Brand Mentions API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Бренд, продукт или тема для поиска (до 100 символов). Фраза в двойных кавычках ищется по точному совпадению. |
content_type | Необязательный | Тип сайтов, с которых собираются упоминания: news, blogs, message-boards, ecommerce или organization. |
results_limit | Необязательный | Количество возвращаемых страниц (1–1000). По умолчанию 100. |
Как использовать Brand Mentions API
Отправьте название бренда или продукта и читайте упоминания построчно.
- Отправьте {"query": "notion", "results_limit": 100} методом POST на /v1/brand-monitoring/mentions.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте страницы из results.items и, пока has_more равно true, запрашивайте следующую страницу через results.next_cursor.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"notion","results_limit":100}'Сценарии использования Brand Mentions API
- Мониторинг репутации: Отмечайте фрагменты, где sentiment.negative выше позитивной оценки, и расставляйте приоритеты по domain_rank страницы.
- Отслеживание публикаций в СМИ: Установите content_type в news и фиксируйте author_name, published_at и domain_rank, чтобы понять, какие издания написали о запуске продукта и с каким охватом.
- Сравнение брендов: Выполните один и тот же запрос для своего бренда и конкурента и сравните типы сайтов, страны и распределение тональности упоминаний.
- Голос сообществ: Ограничьте content_type значением message-boards и соберите ветки, где пользователи описывают продукт своими словами.
Практические советы по Brand Mentions API
- Заключайте названия брендов из нескольких слов в двойные кавычки, например "notion ai", чтобы искать точную фразу.
- Для оценки свежести опирайтесь на published_at, а при его отсутствии — на fetched_at: многие страницы не указывают дату публикации.
- Перед агрегированием тональности уберите строки с высоким spam_score или низким content_quality_score, чтобы малосодержательные страницы не искажали результат.
- Сочетайте с Brand Sentiment Analysis API, когда нужны и детали по каждой странице, и общие доли.
Связанные API
Помимо Brand Mentions API, используйте эти API, когда нужен другой тип публичных данных Brand Monitoring.
- Brand Sentiment Analysis API — Подводите итог одной строкой тому, как в интернете говорят о бренде или теме: число страниц по тональности и эмоциям и основные домены, страны и языки каждой группы.