Primary variant index
primaryCreativeVariantIndex
Optional
Zero when flat fields use the first returned creative card; otherwise null.
Facebook Ads Library Scraper | $0.50/1K Starter | Monitor
Pricing
from $0.30 / 1,000 ad saveds
Scrape Facebook and Instagram ads from Meta Ad Library by keyword, advertiser ID or search URL. Export ad copy and image/video links to CSV or JSON. Resume without duplicates, collect across searches and monitor competitor ad changes. $0.50/1K ads on Starter.
Ad ID
adId
Optional
Source field when available; missing values are null.
Ad Library URL
adUrl
Optional
Source field when available; missing values are null.
Advertiser page ID
pageId
Optional
Source field when available; missing values are null.
Advertiser
pageName
Optional
Source field when available; missing values are null.
Facebook page
pageUrl
Optional
Source field when available; missing values are null.
Active
isActive
Optional
Source field when available; missing values are null.
Start date (UTC)
startDate
Optional
Source field when available; missing values are null.
End date (UTC)
endDate
Optional
Source field when available; missing values are null.
Ad copy
adText
Optional
Source field when available; missing values are null.
Headline
headline
Optional
Source field when available; missing values are null.
description
description
Optional
Source field when available; missing values are null.
Landing page
landingPageUrl
Optional
Source field when available; missing values are null.
Call to action
callToAction
Optional
Source field when available; missing values are null.
Creative format
displayFormat
Optional
Source field when available; missing values are null.
imageUrl
imageUrl
Optional
Source field when available; missing values are null.
videoUrl
videoUrl
Optional
Source field when available; missing values are null.
currency
currency
Optional
Source field when available; missing values are null.
Search country
requestedCountry
Optional
Requested search country; not actual ad targeting or reach.
First matching keyword
searchTerm
Optional
Source field when available; missing values are null.
Observed at (UTC)
observedAt
Optional
Source field when available; missing values are null.
Monitor change
changeType
Optional
Source field when available; missing values are null.
firstSeenAt
firstSeenAt
Optional
Source field when available; missing values are null.
publisherPlatforms
publisherPlatforms
Optional
Available source values; empty when not published.
imageUrls
imageUrls
Optional
Available source values; empty when not published.
videoUrls
videoUrls
Optional
Available source values; empty when not published.
creativeVariants
creativeVariants
Optional
Available source values; empty when not published.
spend
spend
Optional
Published source value only; normally unavailable for commercial ads.
reachEstimate
reachEstimate
Optional
Published source value only; normally unavailable for commercial ads.
Primary variant index
primaryCreativeVariantIndex
Optional
Zero when flat fields use the first returned creative card; otherwise null.
Returned creative cards
creativeVariantCount
Optional
Number of creative cards returned with this ad, not a count of every variant in existence.
Targeted or reached countries
targetedOrReachedCountries
Optional
The source combines targeted and reached countries; these values do not prove actual reach. Empty when not published.
Landing domain
landingPageDomain
Optional
Host of the returned destination URL; this does not verify advertiser ownership.
Platforms
publisherPlatformsText
Optional
Comma-separated publisher platforms for CSV.
Days since start
daysSinceStart
Optional
Calendar days between source start date and observation. Not active runtime or proof of performance.
Images returned
imageCount
Optional
Count of unique returned image URLs.
Videos returned
videoCount
Optional
Count of unique returned video URLs.
Search target number
searchTargetIndex
Optional
One-based input target that first delivered this ad, matching TARGET_REPORT.targetIndex. Overlapping targets are deduplicated.