Brand Monitoring API
Находите веб-страницы, где упоминается бренд, продукт или тема, оценивайте каждую по тональности и эмоциям и подводите итог тому, как о них говорят в интернете.
Доступные API Brand Monitoring
Используйте Brand Mentions API для постраничных данных с оценками тональности и авторитетности или Brand Sentiment Analysis API для одной сводной строки по тональности и эмоциям.
Какие данные мониторинга бренда можно получить?
Оба API работают с одним и тем же массивом проиндексированных веб-страниц: один возвращает страницы, другой — их сводку.
Упоминания на веб-страницах
Заголовок, URL, фрагмент вокруг упоминания, автор, домен, язык, страна и дата публикации или сбора.
Тональность и эмоции
Позитивная, негативная и нейтральная доли с суммой 1 и оценки от 0 до 1 для радости, любви, веселья, желания поделиться, грусти и гнева.
Авторитетность и качество
Ранг домена и страницы от 0 до 1000, а также оценки спама и качества контента от 0 до 100.
Типы сайтов
Является ли страница новостной статьёй, блогом, форумом, страницей интернет-магазина или сайтом организации.
Разбивка тональности
Число страниц в каждой группе тональности и эмоций с основными доменами, странами, языками и типами страниц каждой группы.
Brand Mentions или Brand Sentiment Analysis
Запускайте оба с одной и той же query, когда нужны и общая картина, и стоящие за ней страницы.
| Сравнение | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| Результат | Строка на каждую веб-страницу | Одна сводная строка на query |
| Тональность | Оценки фрагмента каждой страницы | Число страниц в каждой группе тональности и эмоций |
| Источники | Домен, автор, тип сайта и авторитетность каждой страницы | Основные домены, страны, языки и типы страниц по группам |
| Фильтры | query, content_type и results_limit до 1000 | query |
| Стоимость | 10 кредитов за запрос плюс 0,02 за страницу | 10 кредитов за запрос |
Как работает API Brand Monitoring
Оба API используют один и тот же асинхронный процесс задач.
1. Отправьте query
Отправьте бренд, продукт или тему методом POST на /v1/brand-monitoring/mentions или /v1/brand-monitoring/sentiment.
2. Следите за задачей
Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded; для широких запросов это может занять несколько минут.
3. Прочитайте результаты
Прочитайте страницы или сводную строку из results.items.
Авторизуйтесь с помощью API-ключа SocQ и отправьте название бренда. Запрос стоит 10 кредитов плюс 0,02 кредита за каждую возвращённую страницу.
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}'
# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.itemsТипичные сценарии использования API Brand Monitoring
Мониторинг репутации
Отмечайте негативные фрагменты на авторитетных страницах и разбирайте их в первую очередь.
Отслеживание публикаций в СМИ
После запуска или анонса собирайте упоминания в новостях с автором, датой и рангом домена.
Сравнение с конкурентами
Сравнивайте тональность, эмоции и состав источников своего бренда и конкурентов.
Голос сообществ
Собирайте ветки форумов, где люди описывают продукт своими словами.
Итоги кампаний
Сравнивайте группы тональности и эмоций до и после кампании.
Правила запросов и тарифы
Эти правила действуют для обоих API Brand Monitoring.
- query принимает бренд, продукт или тему длиной до 100 символов; фраза в двойных кавычках ищется по точному совпадению.
- Brand Mentions API принимает в content_type значения news, blogs, message-boards, ecommerce или organization и возвращает от 1 до 1000 страниц, по умолчанию 100.
- Большинство сводок тональности готовы меньше чем за минуту; широкий запрос с миллионами подходящих страниц может занять несколько минут.
- Brand Mentions API стоит 10 кредитов за запрос плюс 0,02 кредита за каждую возвращённую страницу; Brand Sentiment Analysis API стоит 10 кредитов за запрос.
Частые вопросы об API Brand Monitoring
Что такое Brand Monitoring API?
Brand Monitoring API находит веб-страницы, где упоминается бренд, продукт или тема, и измеряет их тональность — постранично через Brand Mentions API или в виде сводки через Brand Sentiment Analysis API.
Какие API Brand Monitoring доступны?
Brand Mentions API для отдельных страниц с оценками тональности, эмоций и авторитетности и Brand Sentiment Analysis API для разбивки тональности и эмоций по всем подходящим страницам.
Какие сайты охватываются?
Проиндексированные общедоступные веб-страницы: новостные статьи, блоги, форумы, страницы интернет-магазинов, сайты организаций и другие.
Как измеряется тональность?
Фрагмент вокруг каждого упоминания оценивается как позитивный, негативный или нейтральный и по шести эмоциям; сводка группирует страницы по этим оценкам.
Как тарифицируются запросы Brand Monitoring?
Brand Mentions API стоит 10 кредитов за запрос плюс 0,02 кредита за каждую возвращённую страницу. Brand Sentiment Analysis API стоит 10 кредитов за запрос.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
AI Search API
Отслеживайте, как AI Overviews, ChatGPT и Google AI Mode отвечают на вопросы вашего рынка: ответы, где назван ваш бренд, насколько вы заметны и какие домены и страницы цитируются.
Instagram API
Получайте или находите публичные профили и собирайте записи списков подписчиков, подписки, собственные публикации, публикации с отметкой профиля, результаты по хештегам, Reels, расшифровки, комментарии, счетчики аккаунтов, метрики вовлеченности и метаданные медиа в рамках одного асинхронного процесса.
TikTok API
Собирайте поддерживаемые публичные профили TikTok, метаданные видео по прямым ссылкам, комментарии верхнего уровня, результаты поиска видео и видео по заданным хештегам в едином нормализованном асинхронном процессе.
YouTube API
Собирайте поддерживаемые публичные профили каналов YouTube, данные о видео, видео каналов, комментарии, Shorts, результаты поиска по ключевым словам и хештегам и доступные расшифровки в едином нормализованном асинхронном процессе.
Facebook API
Собирайте публичные профили страниц Facebook, публикации, публикации в группах, комментарии, мероприятия по ключевому слову и доступные расшифровки видео с нормализованными полями идентичности, контента, источника, формата, места, медиа, реакций, посещаемости и вовлеченности.
X API
Собирайте публичные профили, списки подписчиков и подписок, посты, ответы, цитаты, пользователей, сделавших ретвит, результаты поиска и текущие тренды. Используйте единообразные результаты для исследований и мониторинга.

