brand-monitoring/
sentiment

Одним запросом подведите итог тому, как о бренде говорят в интернете: страницы сгруппированы по тональности и эмоциям, с числом страниц, основными сайтами и странами каждой группы.

Brand Sentiment Analysis API

Позитив, негатив, нейтрал
Шесть эмоций
Основные сайты по группам
Страны и языки
10 кредитов за запрос
Готово
Готово

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

README

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

Brand Sentiment Analysis

Тональность бренда — это общий настрой веб-страниц, где он упоминается: как они распределяются между позитивом, негативом и нейтралом и какие эмоции преобладают, от радости и любви до грусти и гнева. В разбивке по сайтам, странам, языкам и типам страниц за каждой группой она показывает, исходит ли критика от СМИ, с форумов или с конкретного рынка, и служит основой для отчётов о репутации, итогов кампаний и сравнения с конкурентами.

Возможности Brand Sentiment Analysis API

  • Три группы тональностиsentiments возвращает позитивную, негативную и нейтральную группы, а mentions_count каждой из них — число отнесённых к ней страниц.
  • Шесть категорий эмоцийemotions группирует те же страницы по самой сильной эмоции: радость, любовь, веселье, желание поделиться, грусть и гнев.
  • Сайты за каждой группойtop_domains перечисляет до 10 сайтов с наибольшим числом страниц в группе и показывает, кто задаёт тон позитивному или негативному обсуждению.
  • Страны, языки и типы страницcountries, languages и page_types показывают, откуда пришли страницы каждой группы. WW означает сайты с глобальной аудиторией, а среди типов есть news, blogs и message-boards.
  • Одна строка на брендОдин запрос возвращает полную разбивку по поисковому запросу, которую можно сразу сохранить как датированный снимок.

Параметры Brand Sentiment Analysis API

ПараметрыОбязательныйОписание
queryОбязательныйБренд, продукт или тема для анализа (до 100 символов). Фраза в двойных кавычках ищется по точному совпадению.

Как использовать Brand Sentiment Analysis API

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

  1. Отправьте {"query": "notion"} методом POST на /v1/brand-monitoring/sentiment.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded. Для широких запросов это может занять несколько минут.
  3. Прочитайте разбивку из results.items. has_more и results.next_cursor подчиняются обычным правилам пагинации и для этого результата из одной строки остаются пустыми.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion"}'

Сценарии использования Brand Sentiment Analysis API

  • Ежемесячный снимок репутации: Каждый месяц фиксируйте mentions_count по каждой группе тональности и стройте график доли негативных страниц во времени.
  • Источник критики: Изучите top_domains, countries и page_types негативной группы и определите, сосредоточена ли критика на нескольких сайтах, в одной стране или на форумах.
  • Сравнение с конкурентами: Проанализируйте свой бренд и бренды конкурентов по одинаково построенным запросам и сравните число позитивных, негативных и нейтральных страниц и преобладающие эмоции.
  • Итоги кампаний: Сравните группы эмоций, например радость или гнев, до и после кампании и посмотрите, как изменилось обсуждение.

Практические советы по Brand Sentiment Analysis API

  • Анализируйте конкретные названия продуктов или кампаний, а не общеупотребительные слова: широкий запрос с миллионами упоминаний может обрабатываться несколько минут.
  • Запускайте анализ конкурентов в тот же день, что и свой, чтобы все снимки отражали одно и то же состояние интернета.
  • Когда показатель группы заметно меняется, вызовите Brand Mentions API с той же query и прочитайте страницы, которые за этим стоят.

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

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

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

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

Brand Sentiment Analysis API — FAQ

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

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

Радость, любовь, веселье, желание поделиться, грусть и гнев. Каждая образует отдельную группу с числом страниц и разбивкой по источникам.

Большинство запросов обрабатывается меньше чем за минуту. Широкий запрос, которому соответствуют миллионы страниц, может занять несколько минут.

10 кредитов за запрос, который возвращает одну строку.