Advertisers

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.

get/v1/advertisers

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/advertisers
  • Auth: HTTP bearer

Query parameters

searchstring[]

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

searchType'brand' | 'domain'

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

keywordMode'any' | 'all'

How multiple search keywords should combine. Defaults to any.

sortBy'relevance' | 'newest' | 'activeAds' | 'newAds' | 'euAdsShare' | 'reach' | 'reach14d' | 'followers'

Primary sort key for advertiser discovery. Defaults to relevance.

order'asc' | 'desc'

Sort order. Ignored when sortBy=relevance because relevance is always ranked descending.

offsetinteger

Pagination offset. Defaults to 0.

limitinteger

Maximum number of advertisers to return. Defaults to 20.

minFbPageCreationDatestring date

Inclusive lower bound for the Facebook page creation date filter.

maxFbPageCreationDatestring date

Inclusive upper bound for the Facebook page creation date filter.

minActiveAdsinteger
maxActiveAdsinteger
adsTimePeriod'current' | 'last24h' | 'last7d' | 'last14d' | 'last30d'

Enum value accepted by this request. Allowed values: current, last24h, last7d, last14d, last30d.

minFacebookLikesinteger
maxFacebookLikesinteger
minInstagramFollowersinteger
maxInstagramFollowersinteger
minAdsLaunchedinteger
maxAdsLaunchedinteger
adsLaunchedPeriod'last24h' | 'last7d' | 'last14d' | 'last30d' | 'last90d'

Time window accepted by this request. Allowed values: last24h, last7d, last14d, last30d, last90d.

minReachinteger

Minimum advertiser reach threshold. In Meta Ad Library vocabulary, reach is the public-facing impressions-style metric where available.

maxReachinteger

Maximum advertiser reach threshold. In Meta Ad Library vocabulary, reach is the public-facing impressions-style metric where available.

reachPeriod'last24h' | 'last7d' | 'last14d' | 'last30d' | 'last90d' | 'total'

Reach/impressions metric window. In Meta Ad Library vocabulary, reach is the public-facing impressions-style metric where available. Allowed values: last24h, last7d, last14d, last30d, last90d, total.

pageTypePublicApiAdvertisersPageType[]

Enum value accepted by this request. Allowed values: influencer, brand.

categoryIdsinteger[]

Google category facet ids matched through linked websites' website_overview.google_categories. Repeated query params and comma-separated values are both accepted.

shopifyLinked'yes' | 'no' | 'all'

Filter by indexed linked-site Shopify technology. no means no indexed Shopify technology is present for the advertiser.

gender'male' | 'female' | 'all'

Enum value accepted by this request. Allowed values: male, female, all.

Response

Paginated advertisers 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": [
    {
      "id": "61554990830184",
      "platform": "facebook",
      "facebookPageId": "61554990830184",
      "name": "Example Brand",
      "logoUrl": "https://medias.trendtrack.io/profile_picture/61554990830184.jpg",
      "profile": {
        "likes": 125000,
        "instagramFollowers": 89000,
        "createdAt": "2019-01-04T00:00:00.000Z"
      },
      "advertising": {
        "activeAds": 12,
        "reach30d": 452000
      },
      "lastAds": [
        {
          "id": "facebook:123456789",
          "mediaUrl": "https://medias.trendtrack.io/facebook/media/ad-1.mp4",
          "thumbnailUrl": "https://medias.trendtrack.io/facebook/thumb/ad-1.jpg"
        }
      ],
      "mainLandingPages": [
        {
          "landingPage": "https://example.com/products/summer",
          "screenshotUrl": "https://medias.trendtrack.io/landing-pages/summer.jpg"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 20,
    "total": 128
  }
}

Changes

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