Brandtrackers

Get brandtracker demography

Returns the EU country / age / gender reach distributions precomputed for the brandtracker. The underlying dataset is page-level and EU-only, so this endpoint is fundamentally EU-scoped.

get/v1/brandtrackers/{brandtrackerId}/demography

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}/demography
  • 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

euOnlyboolean

EU-only filter. This endpoint is fundamentally EU-scoped (the source data is the EU-only fb_page_reach_by_country table), so this defaults to true and is retained for forward compatibility.

snapshotDatestring date

Optional snapshot date (YYYY-MM-DD or latest). The underlying demography data is currently a precomputed per-page snapshot (not time-windowed), so this parameter is accepted for forward compatibility but does not filter the result today.

timePeriod'live' | 'last24h' | 'last3d' | 'last7d' | 'last30d' | 'last3m' | 'last6m' | 'last1y'

Optional time window. The underlying demography data is currently a precomputed per-page snapshot (not time-windowed), so this parameter is accepted for forward compatibility but does not filter the result today.

Response

Brandtracker demography distributions 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": {
    "hasData": true,
    "countryDistribution": [
      {
        "countryCode": "US",
        "reach": 125000
      }
    ],
    "ageDistribution": [
      {
        "ageRange": "25-34",
        "reach": 82000
      }
    ],
    "genderDistribution": [
      {
        "gender": "female",
        "reach": 91000
      }
    ]
  }
}

Changes

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