Get Theme Sentiment

Retrieve sentiment breakdown grouped by theme.

GET /ai-analytics-service/api/public/v1/sentiment/theme/mentions

Get Theme Sentiment

cURL

curl --request GET \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/sentiment/theme/mentions \
  --header 'Authorization: <authorization>'

200

{
  "themes": [
    {
      "themeId": "<string>",
      "positiveSentiment": 123,
      "neutralSentiment": 123,
      "negativeSentiment": 123,
      "positiveSentimentDelta": 123,
      "neutralSentimentDelta": 123,
      "negativeSentimentDelta": 123,
      "totalKeywords": 123
    }
  ]
}

Returns sentiment data grouped by theme. Each theme shows positive, neutral, and negative mention counts with period-over-period change.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

dateRange · integer

Number of days for the analysis window.

from · string

Start of date range. ISO 8601 format (e.g., 2026-02-01T00:00:00Z).

to · string

End of date range. ISO 8601 format.

topicId · number

Filter by topic ID.

brandId · number

Filter by brand ID.

brand · string

Filter by brand name.

platform · string[]

Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

region · string

Filter by ISO country code for region.

sentiment · string

Filter by sentiment label (e.g., positive, neutral, negative).

promptId · number

Filter by a single prompt ID.

promptIds · number[]

Filter by multiple prompt IDs. Maximum 10 values.

Response

Returns 200 OK with an array of theme sentiment objects.

themes · object[] · required

Array of theme sentiment objects.

Show theme sentiment object

themeId · string · required

Unique identifier for the theme.

positiveSentiment · integer · required

Positive mention count for the theme.

neutralSentiment · integer · required

Neutral mention count.

negativeSentiment · integer · required

Negative mention count.

positiveSentimentDelta · integer · required

Change in positive sentiment compared to the previous period.

neutralSentimentDelta · integer · required

Change in neutral sentiment compared to the previous period.

negativeSentimentDelta · integer · required

Change in negative sentiment compared to the previous period.

totalKeywords · integer · required

Number of keywords associated with the theme.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/sentiment/theme/mentions?dateRange=30&topicId=42" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

[
  {
    "themeId": "theme-abc-123",
    "positiveSentiment": 45,
    "neutralSentiment": 30,
    "negativeSentiment": 5,
    "positiveSentimentDelta": 3,
    "neutralSentimentDelta": -1,
    "negativeSentimentDelta": 0,
    "totalKeywords": 12
  },
  {
    "themeId": "theme-def-456",
    "positiveSentiment": 28,
    "neutralSentiment": 42,
    "negativeSentiment": 10,
    "positiveSentimentDelta": -2,
    "neutralSentimentDelta": 5,
    "negativeSentimentDelta": 1,
    "totalKeywords": 8
  }
]

Delta values compare the current period to the previous period of equal length.

Status codes

Status	Description
200	Theme sentiment data returned.
400	promptIds exceeds maximum of 10 values.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Overall Sentiment — View aggregated sentiment across all themes.
• Get Citations — View citation sources.