Skip to main content
GET
Get Global Ad Library Ad

Authorizations

Authorization
string
header
required

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

Path Parameters

ad_id
string<uuid>
required

Response

Successful Response

id
string<uuid>
required
provider
string
required
platform
string
required
source_ad_key
string
required
status
string
required
publisher_platforms
string[]
source_ad_id
string | null
source_ad_url
string | null
display_url
string | null
click_through_url
string | null
landing_page_url
string | null
utm_params
Utm Params · object
paying_agency
AdLibraryOrgSummary · object | null

A parent company or paying agency, by id + display name.

placements
string[]
started_running_at
string<date-time> | null
launched_month
string | null
is_top_ad
boolean
default:false
top_ad_rank
integer | null
low_impression_count
boolean
default:false
ad_has_multiple_versions
boolean
default:false
is_still_in_ad_library
boolean
default:true
last_seen_in_ad_library_at
string<date-time> | null
last_confirmed_active_at
string<date-time> | null
active_finished_at
string<date-time> | null
active_duration_days
integer | null
first_seen_at
string<date-time> | null
last_seen_at
string<date-time> | null
language
string | null
video_duration_seconds
integer | null
industry
string | null
theme
string | null
transcript
AdLibraryTranscript · object | null

Video-ad transcript surfaced on the Full Ad Page (populated by the CU classification branch → AdLibraryAd.classification_json.video.transcript).

is_video
boolean
default:false
posting_page_name
string | null
advertiser_logo_url
string | null
ad_format
string | null
partners
AdLibraryPartnerSummary · object[]
advertiser
AdLibraryAdvertiserSummary · object | null
advertiser_metadata
Advertiser Metadata · object
source_account
AdLibrarySourceAccountSummary · object | null
creatives
AdLibraryCreativeSummary · object[]
observations
AdLibraryObservationSummary · object[]
provider_payloads
AdLibraryProviderPayloadSummary · object[]
platform_details
AdLibraryPlatformDetails · object | null

Typed per-platform transparency projection for the ad detail response.

Exactly one family sub-object is populated (matching family); the rest stay None. Whitelist-projected server-side from ALL stored payload rows (newest-first per key), so scrape mechanics (fetch diagnostics, search/API URLs, run bookkeeping) structurally cannot leak into it.

analysis
AdLibraryAdAnalysisSummary · object | null

Latest completed AI creative-teardown summary embedded on ad detail.

eu_total_reach
integer | null
aaa_info
AdLibraryAaaInfo · object | null

Meta EU DSA ad-transparency block (aaa_info).

Populated only for EU-served Meta ads whose DETAIL page was fetched by the self-hosted scraper (meta_public_scrape). Non-EU ads and ads whose detail was budget-skipped carry no aaa_info.

variant_count
integer
default:1
variants
AdLibraryAdVariant · object[]
viewer_is_admin
boolean
default:false
provenance
Provenance · object