List advertisers
Returns the lightweight public advertisers collection. This endpoint stays intentionally simple and focuses on brand/domain search, pagination, ordering, and stable scalar filters. Use POST /v1/advertisers/query for the advanced discovery surface.
Authorization
publicApiBearer Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.
In: header
Query Parameters
Optional advertiser search keywords. Repeated query params and comma-separated values are both accepted.
Simple search strategy for the advertisers collection. Use POST /v1/advertisers/query for advanced text resolution modes.
"brand""brand" | "domain"How multiple search keywords should combine. Defaults to any.
"any""any" | "all"Primary sort key for advertiser discovery. Defaults to relevance.
"relevance""relevance" | "newest" | "activeAds" | "newAds" | "euAdsShare" | "reach" | "reach14d" | "followers"Sort order. Defaults to desc.
"desc""asc" | "desc"Pagination offset. Defaults to 0.
00 <= valueMaximum number of advertisers to return. Defaults to 20.
201 <= value <= 100Inclusive lower bound for the Facebook page creation date filter.
dateInclusive upper bound for the Facebook page creation date filter.
date0 <= value0 <= value"current""current" | "last24h" | "last7d" | "last14d" | "last30d"0 <= value0 <= value0 <= value0 <= value0 <= value0 <= value"last24h" | "last7d" | "last14d" | "last30d" | "last90d"0 <= value0 <= value"last24h" | "last7d" | "last14d" | "last30d" | "last90d" | "total""yes" | "no" | "all""male" | "female" | "all"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/v1/advertisers"{
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
"data": [
{
"id": "61554990830184",
"platform": "facebook",
"facebookPageId": "61554990830184",
"name": "Example Brand",
"avatarUrl": "https://medias.trendtrack.io/profile_picture/61554990830184.jpg",
"profile": {
"likes": 125000,
"instagramFollowers": 89000,
"createdAt": "2020-05-03T12:00:00.000Z"
},
"advertising": {
"activeAds": 12,
"reach30d": 452000
}
}
],
"pagination": {
"limit": 20,
"offset": 0,
"total": 128
},
"meta": {
"isTruncated": false
}
}{
"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 advertiser detail GET
Returns the page-centric advertiser detail. In this first MVP iteration, advertiserId resolves directly from the Facebook page id.
Query advertisers POST
Returns the advanced public advertisers query surface. This endpoint supports the current richer advertiser discovery filters through a structured public camelCase contract while keeping the response aligned with the standard public advertiser summary shape.