Skip to main content
GET
Get Theme Keyword Sentiment
Returns sentiment data for each keyword within a theme. Use this to identify which keywords drive positive or negative sentiment.

Parameters

string
required
Unique identifier for the theme.
string
required
Bearer token. Format: Bearer slat_<your-token>.
integer
Number of days for the analysis window. Range: 1–365. Default: 30.
string
Start of date range. RFC 3339 timestamp (e.g., 2026-02-01T00:00:00Z). Send together with to.
string
End of date range. RFC 3339 timestamp. Send together with from. Data through the end of this date (UTC) is included. The range can’t exceed 366 days.
number
Filter by topic ID.
number
Filter by brand ID. If omitted, uses the brand of the workspace’s most recently updated prompt.
string
Filter by mentioned brand name. Case-insensitive exact match.
string[]
Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.
string
Filter by ISO country code for region.
string
Filter by sentiment label. One of: positive, neutral, negative (case-insensitive).
integer
Page number (0-indexed). Default: 0.
integer
Page size. Default: 200. Range: 1–200.
number
Filter by a single prompt ID.
number[]
Filter by multiple prompt IDs. Maximum 500 values.

Response

Returns 200 OK with a JSON array of keyword sentiment objects, most-mentioned keywords first. Each object has these fields:
string
required
Unique identifier for the keyword.
string
required
The keyword text.
integer
required
Positive mention count.
integer
required
Neutral mention count.
integer
required
Negative mention count.

Example

Response

Status codes

What’s next