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) orfrom/to,model,collection_id,country_code,language_code,brand_kind,analysis,topic,query,brand(empty for your brand,allfor 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.