Brandtrackers

Count brandtracker partnership ads

Returns the deduped public ad group count matching the partnership ads list filters. This intentionally matches public list pagination semantics rather than the webapp raw active badge count.

get/v1/brandtrackers/{brandtrackerId}/partnership-ads/count

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/brandtrackers/{brandtrackerId}/partnership-ads/count
  • Auth: HTTP bearer

Path parameters

brandtrackerIdstring required
Example:1e08fa85-625a-4ba5-b673-d2a4b7bc7c55

Public brandtracker identifier backed by brandtracker.id. Legacy spyders.uuid values are accepted when migration metadata exists.

Query parameters

status'all' | 'active' | 'inactive'

Status filter for this request. Allowed values: all, active, inactive.

mediaType'all' | 'image' | 'video'

Enum value accepted by this request. Allowed values: all, image, video.

keywordsstring[]

Keyword search terms. Repeated query params and comma-separated values are both accepted.

keywordMode'any' | 'all'

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

createdAfterstring date-time
createdBeforestring date-time
minDaysRunninginteger
maxDaysRunninginteger
minDuplicatesinteger
maxDuplicatesinteger
landingPagesstring[]

Landing page URLs. Repeated query params and comma-separated values are both accepted.

adLanguagestring[]

Ad languages. Repeated query params and comma-separated values are both accepted.

ctastring[]

Call-to-action labels. Repeated query params and comma-separated values are both accepted.

adCopyHashesstring[]

12-character MD5 prefixes for ad copy descriptions.

adCountriesstring
Example:US=include,FR=exclude

Comma-separated country include/exclude filters.

mainCountriesstring[]

Main ad countries. Repeated query params and comma-separated values are both accepted.

euOnlyboolean

When true, keep only ads flagged as EU ads.

partnerIdsstring[]

Partner identifiers. Repeated query params and comma-separated values are both accepted.

minReachinteger

Minimum ad reach threshold. Backed by the internal reach/impressions analytics field.

maxReachinteger

Maximum ad reach threshold. Backed by the internal reach/impressions analytics field.

cpmnumber

CPM used to convert spend filters into reach thresholds.

minSpendnumber
maxSpendnumber
spendPeriod'total' | 'last24h' | 'last7d' | 'last30d'

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

minSpendPerPagenumber
maxSpendPerPagenumber
spendPerPagePeriod'total' | 'last24h' | 'last7d' | 'last30d'

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

hideLowReachboolean

When true, hides ads flagged as low reach.

minAgeinteger
maxAgeinteger
sex'men' | 'women' | 'all'

Enum value accepted by this request. Allowed values: men, women, all.

minFacebookLikesinteger
maxFacebookLikesinteger
minInstagramFollowersinteger
maxInstagramFollowersinteger
minVideoDurationnumber
maxVideoDurationnumber
minDescriptionLengthinteger
maxDescriptionLengthinteger
linkedDomainstring
Example:example.com

Linked domain filter. URLs are normalized to their hostname before validation.

growthRankPublicApiBrandtrackerAdsGrowthRank[]

Rank trend filters. Repeated query params and comma-separated values are both accepted.

snapshotDatestring date

Snapshot date (YYYY-MM-DD or latest). When present, status is interpreted as active at this date.

partnerIdstring

Single partner identifier alias. It is merged with partnerIds when both are provided.

Response

Brandtracker partnership ads count 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"
}

Changes

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