primaryText
Optional
Ad body text. For dynamic (DPA/DCO) ads with {{product.*}} templates, the first card's text.
Meta Ads Library Scraper (Facebook Ads)
Pricing
from $0.60 / 1,000 ad results
For creative strategists, copywriters, media buyers, marketers, and agencies. Scrape the Meta Ad Library by exact phrase, keyword, page, or Library URL. Control country, status, media type, platforms, dates, and impressions sort. $0.60 per 1,000 ads. No Facebook token.
adArchiveId
Required
Ad Library ID (ad_archive_id). Unique per dataset.
itemType
Optional
ad for a newly saved ad (set when emitAdChanges is on), or ad-change when a previously seen ad's snapshot changed. Omitted on plain search items.
adLibraryUrl
Required
Public Ad Library link to this ad.
pageId
Optional
Facebook page ID of the advertiser.
pageName
Optional
pageLikeCount
Optional
pageProfileUrl
Optional
pageProfilePictureUrl
Optional
pageCategories
Optional
primaryText
Optional
Ad body text. For dynamic (DPA/DCO) ads with {{product.*}} templates, the first card's text.
headline
Optional
description
Optional
Link description.
ctaText
Optional
ctaType
Optional
displayFormat
Optional
IMAGE, VIDEO, CAROUSEL, DPA, DCO, MULTI_IMAGES, ...
linkUrl
Optional
Destination URL.
linkCaption
Optional
Display domain under the creative.
imageUrls
Optional
Original image URLs (ad + carousel cards). fbcdn URLs are signed and expire.
videoUrls
Optional
Video URLs, HD and SD (ad + cards). Signed, expire.
videoPreviewImageUrls
Optional
savedMedia
Optional
Present when saveMedia is on. Each successfully stored file: kind (image, video, videoPreview), originalUrl, key, durable url, contentType, size.
savedMediaCount
Optional
Number of files stored for this ad when saveMedia is on.
savedImageUrls
Optional
Durable Apify key-value URLs for saved images and video previews. Original CDN URLs remain in imageUrls / videoPreviewImageUrls.
savedVideoUrls
Optional
Durable Apify key-value URLs for saved videos. Original CDN URLs remain in videoUrls.
mediaStoreId
Optional
Key-value store id that holds saved media for this run.
publisherPlatforms
Optional
FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, THREADS
startDate
Optional
ISO date the ad started delivering.
endDate
Optional
ISO date of the last delivery (for active ads typically today).
isActive
Optional
daysRunning
Optional
Days from startDate to today (active) or endDate (inactive), inclusive.
collationId
Optional
Group ID of near-identical ad versions.
collationCount
Optional
Number of versions in the group.
impressionsText
Optional
Impressions band, only where Meta discloses it (political/issue ads).
impressionsIndex
Optional
spend
Optional
Spend range, only where Meta discloses it (political/issue ads).
currency
Optional
reachEstimate
Optional
Only where disclosed.
categories
Optional
targetedOrReachedCountries
Optional
containsSensitiveContent
Optional
payer
Optional
Who paid for the ad (EU/AAA or financial-services disclosures). Needs scrapeAdDetails.
beneficiary
Optional
Needs scrapeAdDetails.
payerBeneficiary
Optional
targetsEu
Optional
euTotalReach
Optional
EU total reach (EU DSA transparency). Needs scrapeAdDetails.
euAudience
Optional
EU targeting summary: gender, ageMin, ageMax, locations.
instagramUsername
Optional
instagramFollowers
Optional
pageVerification
Optional
detailsFetched
Optional
country
Optional
keyword
Optional
sourceUrl
Optional
foundVia
Optional
ssr = first results page, pagination = cursor pages, fallback = slice fallback when pagination was blocked.
changes
Optional
Only on itemType ad-change. Each entry is { field, before, after } for snapshotted creative fields that differed.
before
Optional
Only on itemType ad-change. The previous snapshot used for comparison.
scrapedAt
Required
snapshot
Optional
Cleaned creative snapshot incl. images, videos and carousel cards[].
raw
Optional
Only with includeRaw: unmodified Meta objects.