Brandtrackers

Get brandtracker time-series

Returns graph-ready Brandtracker time-series for ads launched, live ads history, and EU impression/spend deltas. Use period for rolling windows, or startDate/endDate for explicit ranges; do not combine period with date params.

get/v1/brandtrackers/{brandtrackerId}/time-series

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/brandtrackers/{brandtrackerId}/time-series
  • Auth: HTTP bearer

Path parameters

brandtrackerIdstring required

Public brandtracker identifier. This endpoint resolves brandtracker.id inside the authenticated workspace; legacy spyders.uuid values are accepted when migration metadata exists.

Query parameters

granularity'daily' | 'weekly' | 'monthly'

Bucket size for the returned graph data. Defaults to daily.

startDatestring date

Inclusive start date. Defaults to 365 days before the effective end date. Cannot be combined with period.

endDatestring date

Inclusive end date. Defaults to today unless snapshotDate is provided. Cannot be combined with period.

snapshotDatestring date

Optional snapshot date. When provided with period, it anchors the rolling window; otherwise it is used as the effective end date.

period'today' | 'yesterday' | '1d' | '7d' | '14d' | '30d' | '90d' | '365d'

Optional rolling window for the time-series. Supports today, yesterday, 1d, 7d, 14d, 30d, 90d, and 365d. Cannot be combined with startDate or endDate; snapshotDate may anchor the window.

euOnlyboolean

When true, only EU-classified ads are counted for adsLaunched.

cpmnumber

CPM used to estimate spend from EU impression deltas.

Response

Brandtracker time-series response. The response also includes the X-Request-Id header.

requestIdstring required

Request identifier mirrored in the X-Request-Id response header.

Example response

{
  "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
  "data": {
    "granularity": "daily",
    "dateRange": {
      "startDate": "2026-01-01",
      "endDate": "2026-04-20"
    },
    "adsLaunched": [
      {
        "date": "2026-04-20",
        "count": 12
      }
    ],
    "liveAds": [
      {
        "date": "2026-04-20",
        "count": 12
      }
    ],
    "euImpressionsSpend": [
      {
        "date": "2026-04-20",
        "impressions": 12450,
        "cumulativeImpressions": 431200,
        "estimatedSpend": 112.05
      }
    ],
    "cpm": 9
  },
  "meta": {
    "requestedSnapshotDate": "latest",
    "resolvedSnapshotDate": "2026-04-23",
    "dataFreshnessLagDays": 1,
    "periodNote": "period=today uses the latest ready completed snapshot date instead of partial current-day data."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.