Skip to main content
GET
Get Brand Intelligence Overview Route

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
string<uuid>
required

Query Parameters

per_advertiser_limit
integer | null
Required range: 1 <= x <= 100

Response

Successful Response

brand_id
string<uuid>
required
generated_at
string<date-time>
required
metrics
BrandIntelligenceOverviewMetrics · object
required
watchlists
BrandIntelligenceWatchlistSummary · object[]
recent_ads
AdLibrarySearchAd · object[]
acquisition
BrandIntelligenceAcquisitionStatus · object

In-flight ad acquisition, so half-ingested brand sets read as PENDING.

Competitor ad acquisition fans out per platform: Google Ads Transparency lands in seconds while a self-hosted Meta scrape takes minutes per competitor behind a single-slot browser lane. During that window the tracker's zero counts and Google-only platform pills are TRUE but incomplete, and operators read them as a data bug. These flags let the UI say "still collecting" instead of implying the numbers are final.

Fail-open by construction: an empty payload means "no claim", never "the acquisition finished", so a status-read failure just hides the indicator.

provenance
Provenance · object