Skip to main content
GET
Get Keyword Mention Details
Returns individual mention records for a specific keyword within a theme. Each mention includes the prompt text, AI platform, sentiment label, evidence text, and confidence score.

Parameters

string
required
Unique identifier for the theme.
string
required
Unique identifier for the keyword.
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
Maximum number of results. Default: 50. Range: 1–200.
integer
Number of results to skip. Default: 0.
integer
Page number. When provided, overrides limit/offset with page-based pagination.
integer
Page size. Used with page. Default: the limit value. Maximum: 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 mention detail objects, newest first. Each object has these fields:
string
required
Unique identifier for the mention.
number
required
Associated prompt ID.
string
required
The prompt text that generated the mention.
string
required
Sentiment classification. One of: POSITIVE, NEUTRAL, NEGATIVE.
number
required
Associated topic ID.
string
required
Topic name.
string
required
AI platform that produced the mention.
string
required
Timestamp of the mention.
string
Excerpt from the AI response containing the mention.
integer
Start character position of the mention in the response.
integer
End character position of the mention in the response.
number
required
Associated query run ID.
number
Brand ID referenced in the mention.
string
Name of the brand mentioned.
string
required
Theme ID.
string
required
Keyword ID.
string
required
Keyword text.
number
Numeric sentiment score.
number
Confidence score for the sentiment classification (0–1).

Example

Response

Status codes

What’s next