Brand Sentiment Analysis
El sentimiento de una marca es el tono general de las páginas web que la mencionan: cómo se reparten entre positivo, negativo y neutral, y qué emociones predominan, de la alegría y el amor a la tristeza y el enojo. Desglosado por los sitios, países, idiomas y tipos de página que hay detrás de cada grupo, indica si las críticas vienen de la prensa, de los foros o de un mercado concreto, y sirve para informes de reputación, balances de campaña y comparaciones con la competencia.
Funcionalidades de la Brand Sentiment Analysis API
- Tres grupos de sentimientosentiments devuelve los grupos positivo, negativo y neutral, y el mentions_count de cada uno es el número de páginas clasificadas en él.
- Seis categorías de emociónemotions agrupa las mismas páginas según su emoción más fuerte: alegría, amor, diversión, compartir, tristeza y enojo.
- Los sitios detrás de cada grupotop_domains enumera hasta 10 sitios con más páginas en el grupo y muestra quién impulsa la conversación positiva o negativa.
- Países, idiomas y tipos de páginacountries, languages y page_types muestran de dónde vienen las páginas de cada grupo. WW indica sitios de alcance mundial, y los tipos incluyen news, blogs o message-boards.
- Una fila por marcaUna solicitud devuelve el desglose completo de la búsqueda, listo para guardarse como una instantánea con fecha.
Parámetros de la Brand Sentiment Analysis API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Marca, producto o tema que se analiza (hasta 100 caracteres). Las frases entre comillas dobles se buscan de forma exacta. |
Cómo usar la Brand Sentiment Analysis API
Envíe una marca o un tema y lea el desglose en una sola fila.
- Envíe {"query": "notion"} por POST a /v1/brand-monitoring/sentiment.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded. Con términos amplios puede tardar unos minutos.
- Lea el desglose en results.items. has_more y results.next_cursor siguen las reglas de paginación habituales y quedan vacíos en este resultado de una sola fila.
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"}'Casos de uso de la Brand Sentiment Analysis API
- Instantánea mensual de reputación: Registre cada mes el mentions_count de cada grupo de sentimiento y grafique la proporción de páginas negativas a lo largo del tiempo.
- Ubicar el origen de las críticas: Revise top_domains, countries y page_types del grupo negativo para saber si las críticas se concentran en unos pocos sitios, en un país o en foros.
- Comparación con la competencia: Analice su marca y la de sus competidores con búsquedas construidas igual y compare el número de páginas positivas, negativas y neutrales y las emociones que predominan.
- Balance de campañas: Compare grupos de emoción como la alegría o el enojo antes y después de una campaña para ver cómo cambió la conversación.
Consejos de expertos para la Brand Sentiment Analysis API
- Analice nombres concretos de productos o campañas en lugar de palabras comunes: un término amplio con millones de menciones puede tardar unos minutos.
- Ejecute el análisis de la competencia el mismo día que el suyo, para que todas las instantáneas reflejen el mismo estado de la web.
- Cuando un grupo cambie mucho, llame a Brand Mentions API con la misma query y lea las páginas que hay detrás.
APIs relacionadas
Además de la Brand Sentiment Analysis API, use estas APIs cuando necesite otro tipo de datos públicos de Brand Monitoring.
- Brand Mentions API — Encuentre las páginas web que mencionan una marca, un producto o un tema, con el fragmento, el autor, la fecha, el tipo de sitio, las puntuaciones de sentimiento y emoción y la autoridad de página y dominio.