PublicDocs.sections.referenceAPIAds
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.
Authorization
publicApiBearer AuthorizationBearer <token>
Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.
In: header
Path Parameters
adId*string
Public ad identifier. Currently backed by composite_ad_id.
Query Parameters
limit?integer
Default
365Range
1 <= value <= 365Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/v1/ads/facebook_123456789/reach-history"{
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
"data": [
{
"date": "2026-04-18",
"reach": 152340
}
]
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc"
}
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc"
}
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc"
}
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc"
}
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc"
}
}Get an ad by id GET
Returns a single public ad detail object by ad id. The current backing identifier is the internal composite ad id, but the public contract exposes it as id.
List ads GET
Returns the lightweight public ads collection. This endpoint stays intentionally small and focuses on text search, brand search, simple filters, sorting, and pagination.