Brandtrackers

Get brandtracker timeline metadata

Returns total count and date bounds for the same filter membership used by the brandtracker timeline endpoint.

get/v1/brandtrackers/{brandtrackerId}/timeline/metadata

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}/timeline/metadata
Auth: HTTP bearer

Path parameters

brandtrackerIdstring required

Public brandtracker identifier. This endpoint resolves brandtracker.id inside the authenticated workspace; 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 of ad copy descriptions. Repeated query params and comma-separated values are both accepted.

adCountriesstring

Example:US=include,FR=exclude

Ad country include/exclude filter. Use comma-separated ISO codes with include/exclude modes.

mainCountriesstring[]

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

euOnlyboolean

When true, keep only ads flagged as EU ads.

partnersboolean

When true, keep only partnership ads. When false, keep only non-partnership 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.

startedAfterstring date

Inclusive ad start-date lower bound.

startedBeforestring date

Inclusive ad start-date upper bound.

lastSeenAfterstring date

Inclusive effective timeline end-date lower bound. Active ads use today, or snapshotDate when provided.

lastSeenBeforestring date

Inclusive effective timeline end-date upper bound. Active ads use today, or snapshotDate when provided.

Response

Brandtracker timeline metadata 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": {
    "totalCount": 235,
    "earliestDate": "2026-04-01",
    "latestDate": "2026-04-23"
  }
}

Changes

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