Get Keyword Mention Details

Retrieve individual mention details for a specific keyword within a theme.

GET /ai-analytics-service/api/public/v1/sentiment/theme/{themeId}/keyword/{keywordId}/mentions

Get Keyword Mention Details

cURL

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

200

{
  "mentions": [
    {
      "mentionId": "<string>",
      "promptId": 123,
      "promptText": "<string>",
      "sentimentLabel": "<string>",
      "topicId": 123,
      "topicName": "<string>",
      "platform": "<string>",
      "createdAt": "<string>",
      "evidenceText": "<string>",
      "charStart": 123,
      "charEnd": 123,
      "runId": 123,
      "brandId": 123,
      "mentionedBrandName": "<string>",
      "themeId": "<string>",
      "keywordId": "<string>",
      "keywordLabel": "<string>",
      "sentimentScore": 123,
      "confidence": 123
    }
  ]
}

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

themeId · string · required

Unique identifier for the theme.

keywordId · string · required

Unique identifier for the keyword.

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).

limit · integer

Maximum number of results. Default: 50.

offset · integer

Number of results to skip. Default: 0.

page · integer

Page number. When provided, overrides limit/offset with page-based pagination.

size · integer

Page size. Used with page. Maximum: 200.

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 mention detail objects.

mentions · object[] · required

Array of mention detail objects.

Show mention detail object

mentionId · string · required

Unique identifier for the mention.

promptId · number · required

Associated prompt ID.

promptText · string · required

The prompt text that generated the mention.

sentimentLabel · string · required

Sentiment classification (e.g., positive, neutral, negative).

topicId · number · required

Associated topic ID.

topicName · string · required

Topic name.

platform · string · required

AI platform that produced the mention.

createdAt · string · required

Timestamp of the mention. ISO 8601 format.

evidenceText · string

Excerpt from the AI response containing the mention.

charStart · integer

Start character position of the mention in the response.

charEnd · integer

End character position of the mention in the response.

runId · number · required

Associated query run ID.

brandId · number

Brand ID referenced in the mention.

mentionedBrandName · string

Name of the brand mentioned.

themeId · string · required

Theme ID.

keywordId · string · required

Keyword ID.

keywordLabel · string · required

Keyword text.

sentimentScore · number

Numeric sentiment score.

confidence · number

Confidence score for the sentiment classification (0–1).

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/sentiment/theme/theme-abc-123/keyword/kw-001/mentions?dateRange=30&limit=10" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

[
  {
    "mentionId": "m-2048-001",
    "promptId": 156,
    "promptText": "What is the best project management tool for remote teams?",
    "sentimentLabel": "positive",
    "topicId": 42,
    "topicName": "Project Management Tools",
    "platform": "CHATGPT",
    "createdAt": "2026-02-11T14:31:15Z",
    "evidenceText": "The platform is praised for its ease of use and intuitive interface.",
    "charStart": 245,
    "charEnd": 312,
    "runId": 2048,
    "brandId": 5,
    "mentionedBrandName": "MyBrand",
    "themeId": "theme-abc-123",
    "keywordId": "kw-001",
    "keywordLabel": "ease of use",
    "sentimentScore": 0.92,
    "confidence": 0.87
  }
]

Status codes

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

What’s next

• Get Theme Keyword Sentiment — View keyword-level sentiment aggregates.
• Get Overall Sentiment — View overall sentiment summary.