primaryText
Optional
Ad primary text (up to 2,000 characters)
Ad Library to Winning Angles and Ad Concepts
Pricing
from $5.00 / 1,000 analysed ads
Find which competitor ad angles, hooks and offers run longest in the Meta Ad Library, spot gaps, and get original ad concepts. Pay per ad and concept.
status
Optional
analyzed, skipped (no copy or creative, not charged) or failed (not charged); paid-plan-required: free-plan preview (example result and prices, nothing analysed, not charged)
reason
Optional
Why the ad was skipped or failed
brand
Optional
Advertiser page name
pageId
Optional
Facebook page ID
adArchiveId
Optional
Ad Library ID
adLibraryUrl
Optional
Link to the ad in the Meta Ad Library
startDate
Optional
Date the ad started running (YYYY-MM-DD)
endDate
Optional
Last date the ad ran (YYYY-MM-DD)
isActive
Optional
Still running at scrape time
activeDays
Optional
Days running: start to end date, or to the reference date while active
startedDaysAgo
Optional
Days between the start date and the reference date
isNew
Optional
Started within the new-ads window
longevityIndex
Optional
Days running divided by the brand's median (1.0 = typical for that brand)
longRunner
Optional
Ran 30 days or more
platforms
Optional
Placements: facebook, instagram, audience_network, messenger, threads
mediaType
Optional
image, video, carousel, catalog (dynamic product ad), dynamic (dynamic creative), text, other
displayFormat
Optional
Raw display format from the Ad Library
primaryText
Optional
Ad primary text (up to 2,000 characters)
headline
Optional
Ad headline
linkDescription
Optional
Link description under the headline
ctaText
Optional
CTA button text
ctaType
Optional
CTA button type, e.g. SHOP_NOW
landingDomain
Optional
Landing page domain (tracking redirects skipped)
landingUrl
Optional
Landing page URL without query string
variantsInGroup
Optional
Ads the Ad Library groups with this one (same creative, several versions)
countries
Optional
Targeted or reached countries
angle
Optional
Persuasion angle
angleDetail
Optional
The angle as a generic phrase
hookType
Optional
Hook type
hookPattern
Optional
Reusable hook mechanism, no brand names
offer
Optional
Commercial offer type
offerDetail
Optional
Offer in a few words
emotion
Optional
Main emotion targeted
format
Optional
Creative format
audienceCue
Optional
Customer segment the ad speaks to
visualSummary
Optional
What the image or first video frame shows
copyLanguage
Optional
Language of the copy (ISO 639-1)
summary
Optional
One sentence on what the ad sells and how
visionUsed
Optional
The creative image or first frame was analysed
note
Optional
Why the creative was not looked at, when it was not
priceUsd
Optional
Price charged for this ad
message
Optional
Free-plan preview only: why the Actor did not run on your input
whatYouGet
Optional
Free-plan preview only: what a paid run returns
sampleOutput
Optional
Free-plan preview only: an illustrative example row, not computed from your input
pricing
Optional
Free-plan preview only: price per event in USD
docs
Optional
Free-plan preview only: Actor page with input, output and pricing