Get Overview Trend

Retrieve time series visibility and mention data for your brand and top competitors.

GET /ai-analytics-service/api/public/v1/analytics/overview/trend

Get Overview Trend

cURL

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

200

{
  "points": [
    {
      "date": "<string>",
      "brand": {
        "name": "<string>",
        "mentions": 123,
        "avgPosition": 123,
        "visibilityPct": 123
      },
      "competitors": [
        {
          "name": "<string>",
          "mentions": 123,
          "avgPosition": 123,
          "visibilityPct": 123
        }
      ]
    }
  ]
}

Returns time series data points with brand and competitor metrics per date. Use this to visualize trends in mentions, position, and visibility over time.

Parameters

Authorization · string · required

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

dateRange · integer

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

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.

brandId · number

Brand ID. Optional — if omitted, uses the workspace’s default brand.

topicId · number

Filter by topic ID.

platforms · 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.

bucket · string

Time bucket granularity. One of: day, week, month. Default: day.

topCompetitors · integer

Number of top competitors to include in the trend. Default: 5.

promptId · number

Filter by a single prompt ID.

promptIds · number[]

Filter by multiple prompt IDs. Maximum 10 values.

Response

Returns 200 OK with the trend data.

points · object[] · required

Array of time series data points.

Show trend point

date · string · required

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

brand · object · required

Brand metrics for the date.

Show entity metrics

name · string · required

Brand name.

mentions · integer · required

Mention count.

avgPosition · number

Average position.

visibilityPct · number

Visibility percentage.

competitors · object[]

Competitor metrics for the date.

Show entity metrics

name · string · required

Competitor name.

mentions · integer · required

Mention count.

avgPosition · number

Average position.

visibilityPct · number

Visibility percentage.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/overview/trend?dateRange=30&topicId=42&bucket=day&topCompetitors=3" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

{
  "points": [
    {
      "date": "2026-02-10",
      "brand": {
        "name": "MyBrand",
        "mentions": 15,
        "avgPosition": 2.1,
        "visibilityPct": 80.0
      },
      "competitors": [
        {
          "name": "CompetitorA",
          "mentions": 10,
          "avgPosition": 3.2,
          "visibilityPct": 65.0
        }
      ]
    },
    {
      "date": "2026-02-11",
      "brand": {
        "name": "MyBrand",
        "mentions": 18,
        "avgPosition": 2.0,
        "visibilityPct": 82.0
      },
      "competitors": [
        {
          "name": "CompetitorA",
          "mentions": 12,
          "avgPosition": 3.0,
          "visibilityPct": 68.0
        }
      ]
    }
  ]
}

Status codes

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

What’s next

• Get Overview Summary — View aggregated KPIs.
• Get Citations Summary — View citation analytics.