Brandtrackers

Get brandtracker headline evolution

Returns graph-ready headline evolution series for one active workspace brandtracker resolved from brandtracker.id. Provide headline for exact single-text mode, or omit it to page through bounded global series ranked by active ads.

get/v1/brandtrackers/{brandtrackerId}/headline-evolution

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}/headline-evolution
  • 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

pageinteger

Pagination page number for global mode. Exact mode always returns at most one series.

limitinteger

Number of series to return in global mode. Exact mode costs and returns one series.

startDatestring date

Inclusive start date. Defaults to 365 days before the effective end date.

endDatestring date

Inclusive end date. Defaults to today unless snapshotDate is provided.

snapshotDatestring date

Optional snapshot date. When provided, it is used as the effective end date.

headlinestring

Exact headline text to return as a single evolution series. Omit for global mode.

Response

Paginated headline evolution response. Pagination is by distinct headline series and the response 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",
  "dateRange": {
    "startDate": "2026-01-01",
    "endDate": "2026-04-20"
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 128,
    "totalPages": 7
  },
  "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."
  },
  "data": [
    {
      "headline": "The ritual your skin was waiting for",
      "points": [
        {
          "date": "2026-04-20",
          "recordedAt": "2026-04-20T12:30:00.000Z",
          "activeAds": 12,
          "totalAds": 48,
          "euAds": 9,
          "euActiveAds": 7,
          "totalReach": 124500,
          "percentNewAds": 18.5
        }
      ]
    }
  ]
}

Changes

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