Sentiments

Sentiment records with their comments, topics and scores, plus the category catalog used to label them. Growth plan or above required.

GET/sentiments

List detailed sentiment records with full analysis context. Requires the Growth plan or higher.

  • Access: Growth plan or higher. Params: project_id (required), model, competitor_id, brand_only, analysis (very_positive/positive/neutral/negative/very_negative), collection_id, prompt (prompt ID), country_code, language_code, from, to, page, per_page.

GET/dimensions/sentiments

(Optional) Lists available sentiment categories and their metric keys. Requires the Growth plan or higher.

  • Access: Growth plan or higher. Params: project_id (required).

GET/reports/sentiment/topics

The Topics table of the Sentiment page: for each topic AI answers associate with the brand, its analyzed mentions, the positive, neutral and negative counts, their shares and the net sentiment score. Growth plan and above. Also available as the MCP tool get_sentiment_topics.

  • Params: project_id (required), range (default 28 days) or from/to, model, collection_id, country_code, language_code, brand_kind, analysis, topic, query, brand (empty for your brand, all for every brand, or a competitor id), sort (mentions|name|positive|negative|neutral|net_score), sort_dir (desc|asc), page, per_page, output.

GET/reports/sentiment/tags

The Tags table of the Sentiment page: for each tag with analyzed mentions, the positive, neutral and negative counts, their shares and the net sentiment score. A mention counts once for every tag its prompt carries. Growth plan and above. Also available as the MCP tool get_sentiment_tags.

  • Same params as GET /reports/sentiment/topics.