Ads

Get ad reach history

Returns the public daily reach history for one ad. The series is intentionally lightweight and keeps reach as the canonical metric term.

get/v1/ads/{adId}/reach-history

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/ads/{adId}/reach-history
  • Auth: HTTP bearer

Path parameters

adIdstring required
Example:facebook_123456789

Trendtrack ad identifier returned as adId by the Public API.

Query parameters

limitinteger

Response

Public ad reach history 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": [
    {
      "date": "2026-04-18",
      "reach": 152340
    }
  ]
}

Changes

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