Get advertiser detail
Returns the page-centric advertiser detail. In this first MVP iteration, advertiserId resolves directly from the Facebook page id.
Authorization
publicApiBearer Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.
In: header
Path Parameters
Public advertiser identifier. Current MVP uses the Facebook page id directly.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/v1/advertisers/61554990830184"{
"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"
},
"linkedShops": [
{
"shopId": "3f8aa146-6f96-46e8-9781-64db5166f9a8",
"domain": "example.com",
"name": "Example Shop",
"isPrimary": true
}
],
"advertising": {
"activeAds": 12,
"reach30d": 452000,
"countryDistribution": [
{
"countryCode": "US",
"share": 0.42
}
]
}
}
}{
"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"
}
}List ads for an advertiser GET
Returns a paginated list of ads for the requested page-centric advertiser. In this first MVP iteration, advertiserId resolves directly from the Facebook page id.
List advertisers GET
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.