Sentimentos

Registos de sentimento com os respetivos comentários, temas e pontuações, bem como o catálogo de categorias usado para os etiquetar. É necessário o plano Growth ou superior.

GET/sentiments

Lista registos detalhados de sentimento, com todo o contexto da análise. Requer o plano Growth ou superior.

  • Acesso: plano Growth ou superior. Parâmetros: project_id (obrigatório), model, competitor_id, brand_only, analysis (very_positive/positive/neutral/negative/very_negative), collection_id, prompt (ID do prompt), country_code, language_code, from, to, page, per_page.

GET/dimensions/sentiments

(Opcional) Lista as categorias de sentimento disponíveis e as respetivas chaves das métricas. Requer o plano Growth ou superior.

  • Acesso: plano Growth ou superior. Parâmetros: project_id (obrigatório).

GET/reports/sentiment/topics

A tabela de tópicos da página Sentimento: para cada tópico que as respostas de IA associam à marca, as menções analisadas, as contagens de menções positivas, neutras e negativas, as respetivas percentagens e a pontuação de sentimento líquido. Plano Growth ou superior. Também disponível como a ferramenta MCP get_sentiment_topics.

  • Parâmetros: project_id (obrigatório), range (predefinição 28 dias) ou from/to, model, collection_id, country_code, language_code, brand_kind, analysis, topic, query, brand (vazio para a sua marca, all para todas as marcas ou um id de concorrente), sort (mentions|name|positive|negative|neutral|net_score), sort_dir (desc|asc), page, per_page, output.

GET/reports/sentiment/tags

A tabela de etiquetas da página Sentimento: para cada etiqueta com menções analisadas, as contagens de menções positivas, neutras e negativas, as respetivas percentagens e a pontuação de sentimento líquido. Uma menção conta uma vez por cada etiqueta que o respetivo prompt tem. Plano Growth ou superior. Também disponível como a ferramenta MCP get_sentiment_tags.

  • Os mesmos parâmetros que GET /reports/sentiment/topics.