Get Trends

Retrieve visibility and mention trends over time, optionally including competitor data.

GET /ai-analytics-service/api/public/v1/analytics/trends

Get Trends

cURL

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

200

{
  "trends": [
    {
      "date": "<string>",
      "mentions": 123,
      "position": 123,
      "visibilityScore": 123,
      "shareOfVoice": 123,
      "competitors": {
        "brandMentions": 123,
        "position": 123,
        "visibility": 123,
        "shareOfVoice": 123,
        "entityName": "<string>",
        "date": "<string>"
      }
    }
  ]
}

Returns daily trend data for brand mentions, position, visibility score, and share of voice over a specified date range. Optionally includes competitor comparison data.

Parameters

Authorization · string · required

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

dateRange · integer · required

Number of days for the trend window (e.g., 7, 30, 90).

topicId · number

Filter by topic ID.

includeCompetitors · boolean

Set to true to include competitor trend data alongside your brand.

platform · string[]

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

promptId · number

Filter by prompt ID.

runId · number

Filter by a specific query run ID.

Response

Returns 200 OK with an array of daily trend data points.

trends · object[] · required

Array of daily trend objects.

Show trend object

date · string · required

Date for the data point. Format: YYYY-MM-DD.

mentions · integer · required

Number of brand mentions on the date.

position · number · required

Average brand position in AI responses.

visibilityScore · number · required

Visibility score (0–100).

shareOfVoice · number · required

Share of voice percentage.

competitors · object

Competitor data keyed by competitor name. Only present when includeCompetitors=true.

Show competitor data

brandMentions · integer

Competitor’s mention count.

position · number

Competitor’s average position.

visibility · number

Competitor’s visibility score.

shareOfVoice · number

Competitor’s share of voice.

entityName · string

Competitor name.

date · string

Date for the data point.

Example

cURL

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

Response

[
  {
    "date": "2026-02-10",
    "mentions": 42,
    "position": 2,
    "visibilityScore": 85,
    "shareOfVoice": 35.5,
    "competitors": {
      "CompetitorA": {
        "brandMentions": 30,
        "position": 3,
        "visibility": 70,
        "shareOfVoice": 25.0,
        "entityName": "CompetitorA",
        "date": "2026-02-10"
      }
    }
  },
  {
    "date": "2026-02-11",
    "mentions": 45,
    "position": 2,
    "visibilityScore": 87,
    "shareOfVoice": 36.2,
    "competitors": {
      "CompetitorA": {
        "brandMentions": 28,
        "position": 4,
        "visibility": 68,
        "shareOfVoice": 23.5,
        "entityName": "CompetitorA",
        "date": "2026-02-11"
      }
    }
  }
]

Status codes

Status	Description
200	Trend data returned.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Metrics — Get aggregated performance metrics.
• Get Share of Voice — Compare share of voice across brands.