brand-monitoring/
mentions

Находите веб-страницы, где упоминается бренд, продукт или тема, и получайте для каждой фрагмент текста, автора, дату, тип сайта, оценки тональности и авторитетность.

Brand Mentions API

Упоминания по всему вебу
Тональность фрагмента
Фильтр по типу сайта
Авторитетность и спам-оценка
10 кредитов за запрос + 0,02 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

Отправьте название бренда или продукта и читайте упоминания построчно.

  1. Отправьте {"query": "notion", "results_limit": 100} методом POST на /v1/brand-monitoring/mentions.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте страницы из 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, когда нужны и детали по каждой странице, и общие доли.

Помимо Brand Mentions API, используйте эти API, когда нужен другой тип публичных данных Brand Monitoring.

  • Brand Sentiment Analysis API — Подводите итог одной строкой тому, как в интернете говорят о бренде или теме: число страниц по тональности и эмоциям и основные домены, страны и языки каждой группы.

Другие платформы

Объединяйте данные Brand Monitoring с публичными данными других поддерживаемых соцсетей.

Brand Mentions API — FAQ

Brand Mentions API находит веб-страницы, где упоминается бренд, продукт или тема, и возвращает для каждой фрагмент текста, автора, дату, тип сайта, оценки тональности и эмоций, а также оценки авторитетности и спама.

Проиндексированные веб-страницы, текст которых соответствует запросу: новостные статьи, обзоры в блогах, форумы, карточки товаров в интернет-магазинах, сайты компаний и другие. С помощью content_type можно выбрать один из этих типов.

По фрагменту вокруг упоминания: sentiment даёт позитивную, негативную и нейтральную доли с суммой 1, а emotions — оценку от 0 до 1 для каждой из шести эмоций.

Да. Заключите название в query в двойные кавычки, чтобы получить точное совпадение.

10 кредитов за запрос плюс 0,02 кредита за каждую возвращённую страницу. 10 кредитов списываются и в том случае, если страницы не найдены.