Brandtrackers

Get brandtracker landing page evolution

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

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

landingPagestring

Exact landing page URL to return as a single evolution series. Omit for global mode.

Response

Paginated landing page evolution response. Pagination is by distinct landing page 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": [
    {
      "landingPage": "https://example.com/products/ritual-kit",
      "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.