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
Отправьте бренд или тему и прочитайте разбивку одной строкой.
- Отправьте {"query": "notion"} методом POST на /v1/brand-monitoring/sentiment.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded. Для широких запросов это может занять несколько минут.
- Прочитайте разбивку из 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 и прочитайте страницы, которые за этим стоят.
Связанные API
Помимо Brand Sentiment Analysis API, используйте эти API, когда нужен другой тип публичных данных Brand Monitoring.
- Brand Mentions API — Находите веб-страницы, где упоминается бренд, продукт или тема, с фрагментом текста, автором, датой, типом сайта, оценками тональности и эмоций и авторитетностью страницы и домена.