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

AuthorizationBearer <token>

Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.

In: header

Query Parameters

search?array<string>

Optional advertiser search keywords. Repeated query params and comma-separated values are both accepted.

searchType?string

Simple search strategy for the advertisers collection. Use POST /v1/advertisers/query for advanced text resolution modes.

Default"brand"

Value in"brand" | "domain"

keywordMode?string

How multiple search keywords should combine. Defaults to any.

Default"any"

Value in"any" | "all"

sortBy?string

Primary sort key for advertiser discovery. Defaults to relevance.

Default"relevance"

order?string

Sort order. Defaults to desc.

Default"desc"

Value in"asc" | "desc"

offset?integer

Pagination offset. Defaults to 0.

Default0

Range0 <= value

limit?integer

Maximum number of advertisers to return. Defaults to 20.

Default20

Range1 <= value <= 100

minFbPageCreationDate?string

Inclusive lower bound for the Facebook page creation date filter.

Formatdate

maxFbPageCreationDate?string

Inclusive upper bound for the Facebook page creation date filter.

Formatdate

minActiveAds?integer

Range0 <= value

maxActiveAds?integer

Range0 <= value

adsTimePeriod?string

Default"current"

Value in"current" | "last24h" | "last7d" | "last14d" | "last30d"

minFacebookLikes?integer

Range0 <= value

maxFacebookLikes?integer

Range0 <= value

minInstagramFollowers?integer

Range0 <= value

maxInstagramFollowers?integer

Range0 <= value

minAdsLaunched?integer

Range0 <= value

maxAdsLaunched?integer

Range0 <= value

adsLaunchedPeriod?string

Value in"last24h" | "last7d" | "last14d" | "last30d" | "last90d"

minReach?integer

Range0 <= value

maxReach?integer

Range0 <= value

reachPeriod?string

pageType?array<>

shopifyLinked?string

Value in"yes" | "no" | "all"

gender?string

Value in"male" | "female" | "all"

Response Body

`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"
  }
}

Authorization

Query Parameters

Response Body

200application/json

401application/json

403application/json

500application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`