Brandtrackers

Get brandtracker ad copy evolution

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

get/v1/brandtrackers/{brandtrackerId}/ad-copy-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}/ad-copy-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.

adCopystring

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

Response

Paginated ad copy evolution response. Pagination is by distinct ad copy 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": [
    {
      "adCopy": "Turn your mornings into a ritual.",
      "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.