Skip to main content
GET
Get Trends
Returns daily trend data for brand mentions, position, visibility score, and share of voice over a specified date range. Each day also includes competitor and other-entity data.

Parameters

string
required
Bearer token. Format: Bearer slat_<your-token>.
integer
Number of days for the trend window (e.g., 7, 30, 90). Range: 1–365. Default: 30.
number
Filter by topic ID.
string[]
Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.
number
Filter by prompt ID.
number
Filter by a specific query run ID.

Response

Returns 200 OK with a JSON array of daily trend objects, oldest date first. Each object has these fields:
string
required
Date for the data point. Format: YYYY-MM-DD.
integer
required
Number of query runs on the date that mentioned your brand.
number
required
Average brand position in AI responses, rounded to a whole number.
integer
required
Visibility score (0–100), rounded to a whole number.
integer
required
Brand’s share of all entity mentions on the date, as a whole-number percentage.
object
required
Competitor data keyed by competitor name.
object
required
Data for other mentioned entities (not your brand or a tracked competitor), keyed by entity name. Each value has the same fields as a competitors entry, with entityType set to OTHER.

Example

Response

Status codes

What’s next