Creative preview
primaryImageUrl
Optional
First available creative image URL, exposed for dataset preview cards.
Facebook & Meta Ads Library Scraper + Tracker
Pricing
from $0.60 / 1,000 baseline ad results
Scrape Facebook and Meta Ads Library creatives, copy, CTAs and landing links. Track competitor ads and detect new, updated and safely ended ads.
Ad ID
adId
Optional
Public Meta Ad Library identifier for this ad.
Page id
pageId
Optional
Page id returned by the Meta Ad Library source when available.
Advertiser
pageName
Optional
Name of the Facebook page running the ad.
Page categories
pageCategories
Optional
Page categories returned by the Meta Ad Library source when available.
[ "example"]Page entity type
pageEntityType
Optional
Page entity type returned by the Meta Ad Library source when available.
Start date
startDate
Optional
Start date returned by the Meta Ad Library source when available.
End date
endDate
Optional
End date returned by the Meta Ad Library source when available.
State
state
Optional
State returned by the Meta Ad Library source when available.
Collation count
collationCount
Optional
Collation count returned by the Meta Ad Library source when available.
Ad archive ad count
adArchiveAdCount
Optional
Ad archive ad count returned by the Meta Ad Library source when available.
Bodies
bodies
Optional
Bodies returned by the Meta Ad Library source when available.
[ "example"]Cta texts
ctaTexts
Optional
Cta texts returned by the Meta Ad Library source when available.
[ "example"]Card titles
cardTitles
Optional
Card titles returned by the Meta Ad Library source when available.
[ "example"]Card descriptions
cardDescriptions
Optional
Card descriptions returned by the Meta Ad Library source when available.
[ "example"]Card captions
cardCaptions
Optional
Card captions returned by the Meta Ad Library source when available.
[ "example"]Observed link urls
observedLinkUrls
Optional
Observed link urls returned by the Meta Ad Library source when available.
[ "example"]Snapshot urls
snapshotUrls
Optional
Snapshot urls returned by the Meta Ad Library source when available.
[ "example"]Display format
displayFormat
Optional
Display format returned by the Meta Ad Library source when available.
Publisher platforms
publisherPlatforms
Optional
Publisher platforms returned by the Meta Ad Library source when available.
[ "example"]Impressions lower bound
impressionsLowerBound
Optional
Impressions lower bound returned by the Meta Ad Library source when available.
Impressions upper bound
impressionsUpperBound
Optional
Impressions upper bound returned by the Meta Ad Library source when available.
Is political
isPolitical
Optional
Is political returned by the Meta Ad Library source when available.
Country
country
Optional
Country returned by the Meta Ad Library source when available.
Query id
queryId
Optional
Query id returned by the Meta Ad Library source when available.
Query kind
queryKind
Optional
Query kind returned by the Meta Ad Library source when available.
Query
query
Optional
Query returned by the Meta Ad Library source when available.
Coverage status
coverageStatus
Optional
Coverage status returned by the Meta Ad Library source when available.
Source exhausted
sourceExhausted
Optional
Source exhausted returned by the Meta Ad Library source when available.
Ad Library URL
adLibraryUrl
Optional
Direct link to the ad in Meta Ad Library.
Observed destination url
observedDestinationUrl
Optional
Observed destination url returned by the Meta Ad Library source when available.
Resolved final landing url
resolvedFinalLandingUrl
Optional
Resolved final landing url returned by the Meta Ad Library source when available.
Intermediary url
intermediaryUrl
Optional
Intermediary url returned by the Meta Ad Library source when available.
Intermediary domain
intermediaryDomain
Optional
Intermediary domain returned by the Meta Ad Library source when available.
Redirect chain
redirectChain
Optional
Redirect chain returned by the Meta Ad Library source when available.
[ "example"]Landing domain
landingDomain
Optional
Landing domain returned by the Meta Ad Library source when available.
Landing resolution status
landingResolutionStatus
Optional
Landing resolution status returned by the Meta Ad Library source when available.
Landing resolution reason
landingResolutionReason
Optional
Landing resolution reason returned by the Meta Ad Library source when available.
Landing evidence
landingEvidence
Optional
Landing evidence returned by the Meta Ad Library source when available.
Material fingerprint
materialFingerprint
Optional
Material fingerprint returned by the Meta Ad Library source when available.
Stable change event ID
changeEventId
Optional
Deterministic ID for deduplicating a rare at-least-once Changes replay after a state-store failure.
Change
changeStatus
Optional
Change versus the last complete snapshot: NEW, UPDATED, UNCHANGED or ENDED.
Changed fields
changedFields
Optional
Fields whose material values changed since the previous complete snapshot.
[ "bodies", "ctaTexts"]Observed at
observedAt
Optional
UTC timestamp when this row was collected.
Internal ad ID
adInternalId
Optional
Internal ad ID returned by the Meta Ad Library source when available.
Advertiser page like count
pageLikeCount
Optional
Advertiser page like count returned by the Meta Ad Library source when available.
Advertiser page profile URL
pageProfileUri
Optional
Advertiser page profile URL returned by the Meta Ad Library source when available.
Advertiser page profile picture URL
pageProfilePictureUrl
Optional
Advertiser page profile picture URL returned by the Meta Ad Library source when available.
Advertiser page is deleted
pageIsDeleted
Optional
Advertiser page is deleted returned by the Meta Ad Library source when available.
Ad currently active
isActive
Optional
Ad currently active returned by the Meta Ad Library source when available.
Collation ID
collationId
Optional
Collation ID returned by the Meta Ad Library source when available.
CTA types
ctaTypes
Optional
CTA types returned by the Meta Ad Library source when available.
[ "example"]Ad byline
byline
Optional
Ad byline returned by the Meta Ad Library source when available.
Ad disclaimer label
disclaimerLabel
Optional
Ad disclaimer label returned by the Meta Ad Library source when available.
Ad disclosed country code
countryIsoCode
Optional
Ad disclosed country code returned by the Meta Ad Library source when available.
Creative image URLs
imageUrls
Optional
Creative image URLs returned by the Meta Ad Library source when available.
[ "example"]Creative video URLs
videoUrls
Optional
Creative video URLs returned by the Meta Ad Library source when available.
[ "example"]Impressions text (political/EU only)
impressionsText
Optional
Impressions text (political/EU only) returned by the Meta Ad Library source when available.
Impressions index (political/EU only)
impressionsIndex
Optional
Impressions index (political/EU only) returned by the Meta Ad Library source when available.
Reach estimate (political/EU only)
reachEstimate
Optional
Reach estimate (political/EU only) returned by the Meta Ad Library source when available.
Spend (political/EU only)
spend
Optional
Spend (political/EU only) returned by the Meta Ad Library source when available.
Spend currency
currency
Optional
Spend currency returned by the Meta Ad Library source when available.
Ad categories
categories
Optional
Ad categories returned by the Meta Ad Library source when available.
[ "example"]Targeted or reached countries
targetedOrReachedCountries
Optional
Targeted or reached countries returned by the Meta Ad Library source when available.
[ "example"]Total active time (seconds)
totalActiveTime
Optional
Total active time (seconds) returned by the Meta Ad Library source when available.
Contains sensitive content
containsSensitiveContent
Optional
Contains sensitive content returned by the Meta Ad Library source when available.
Contains digitally created media
containsDigitalCreatedMedia
Optional
Contains digitally created media returned by the Meta Ad Library source when available.
Meta disclosure eligibility status
gatedType
Optional
Meta disclosure eligibility status returned by the Meta Ad Library source when available.
Meta archive types
archiveTypes
Optional
Meta archive types returned by the Meta Ad Library source when available.
[ "example"]Political disclosure countries
politicalCountries
Optional
Political disclosure countries returned by the Meta Ad Library source when available.
[ "example"]Public report count
reportCount
Optional
Public report count returned by the Meta Ad Library source when available.
Requested country scope
requestedCountry
Optional
Requested country scope returned by the Meta Ad Library source when available.
Creative preview
primaryImageUrl
Optional
First available creative image URL, exposed for dataset preview cards.