Skip to main content
GET
Get Global Ad Library Advertiser Paid Search

Authorizations

Authorization
string
header
required

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

Path Parameters

advertiser_id
string<uuid>
required

Response

Successful Response

Global paid-search evidence for ONE advertiser identity.

The Brand Details Paid Search read (vault 25.3: advertiser_id is the key for "identity across ads, reviews, profiles, group members, Brand Details"). Keyed by advertiser, never by brand_id — the tenant axis is independent of global market facts (BI-D04), so this shape carries no tenant field at all and cannot be re-scoped to one workspace's competitor list.

Deliberately WITHOUT overlap_keyword_count / gap_keyword_count / shared+gap keyword arrays. Those are "capturing brand vs this competitor" projections; serving another tenant's copy would leak that tenant's keyword footprint (BI-D03). The exclusion lives in the model so it survives edits to the service.

measured=False means no capture exists for this domain anywhere. It is NOT the same as a capture that measured zero paid keywords, which arrives measured=True with zeroes (BI-D10). Neither state is an error and neither is retryable — acquisition is a background/operator path (BI-D09).

advertiser_id
string<uuid>
required
measured
boolean
required
advertiser_name
string | null
domain
string | null
captured_at
string<date-time> | null
creatives_captured_at
string<date-time> | null
location_code
integer | null
language_code
string | null
source
string | null
creatives_location_code
integer | null
creatives_language_code
string | null
creatives_source
string | null
paid_keyword_count
integer | null
est_monthly_spend_usd
number | null
est_paid_traffic
number | null
avg_cpc_usd
number | null
paid_vs_organic_ratio
number | null
active_ad_count
integer | null
keywords
KeywordRow · object[]
google_ads
Google Ads · object[]
spend_points
SpendSeriesPoint · object[]
estimate_notice
string
default:Estimated — spend, traffic, CPC, keyword count and active ads are all modelled from competitor paid keywords. Not actual competitor figures.