Primary media
primary_media_url
Required
First direct image URL or preferred HD/SD video URL.
Facebook Ads Library Scraper
Pricing
from $0.50 / 1,000 results
Facebook Ads Library scraper for competitor research. Find active Meta ads by keyword or Page, export ad text, images, videos, and landing pages.
Pricing
from $0.50 / 1,000 results
Rating
0.0
(0)
Developer
devcake
Maintained by CommunityActor stats
1
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Record type
record_type
Required
Stable discriminator for dataset consumers.
Search query
search_query
Required
Keyword that produced the row, or null for Page-only inputs.
Requested Page ID
search_page_id
Required
Resolved or explicitly requested advertiser Page ID for Page searches.
Source URL
search_source_url
Required
Facebook Page or Ads Library URL that produced the row.
Search type
search_type
Required
Normalized search mode used for this row.
Requested country
country_code
Required
Ads Library delivery-country filter, not proof that the ad reached that country.
Ad Library ID
ad_archive_id
Required
Meta's stable public archive identifier.
Ad Library URL
library_url
Required
Direct public Ads Library URL for this archive ID.
Ad ID
ad_id
Required
Meta ad ID when separately exposed; often null.
Facebook Page ID
page_id
Required
Numeric advertiser Page identifier.
Advertiser
page_name
Required
Advertiser Page display name.
Page URL
page_profile_url
Required
Public advertiser Page URL.
Page image
page_profile_picture_url
Required
Advertiser profile image URL; CDN links can expire.
Page categories
page_categories
Required
Meta-provided advertiser categories.
Page likes
page_like_count
Required
Page like count when exposed in the creative snapshot.
Active
is_active
Required
Whether Meta marks the ad as actively delivering.
Started
start_date
Required
Normalized delivery start timestamp.
Ended
end_date
Required
Normalized stop timestamp; always null while is_active is true.
Meta source end date
source_end_date
Required
Unmodified end timestamp supplied by Meta. Meta can populate it for active ads, so consumers should use end_date for stopped-ad analysis.
Days running
days_running
Required
Whole days from start_date to end_date, or to scrape time for active ads.
Platforms
publisher_platforms
Required
Meta surfaces where the ad was delivered.
Reached countries
targeted_or_reached_countries
Required
Countries disclosed by Meta for this ad; commonly empty for commercial ads.
Ad categories
categories
Required
Meta special-ad or archive categories.
Source primary text
body
Required
Top-level creative body, which may contain a DCO template token.
Source headline
title
Required
Top-level creative title, which may contain a DCO template token.
Resolved primary text
resolved_body
Required
First usable non-template body from the top-level creative or its cards.
Resolved headline
resolved_title
Required
First usable non-template title from the top-level creative or its cards.
Creative body variants
creative_bodies
Required
Unique non-null card body variants.
Creative title variants
creative_titles
Required
Unique non-null card title variants.
Caption
caption
Required
Top-level creative caption.
Link description
link_description
Required
Top-level landing-card description.
Landing URL
link_url
Required
Top-level destination URL, including tracking parameters.
Landing URLs
landing_urls
Required
Unique top-level, card, and extra destination URLs.
Landing domain
landing_domain
Required
Hostname of the first landing URL.
CTA type
cta_type
Required
Meta call-to-action enum.
CTA text
cta_text
Required
Displayed call-to-action label.
Meta display format
display_format
Required
Unmodified Meta creative display format such as DCO, IMAGE, or VIDEO.
Creative type
creative_type
Required
Normalized creative classification. DYNAMIC takes precedence for DCO or templated creatives.
Dynamic creative
is_dynamic_creative
Required
True for DCO, template-token, or collated multi-variant creatives.
Primary media
primary_media_url
Required
First direct image URL or preferred HD/SD video URL.
Creative preview
primary_thumbnail_url
Required
First image or video preview URL for table and integration previews.
Images
image_urls
Required
Unique original, resized, extra, and per-card creative images.
Image count
image_count
Required
Number of URLs in image_urls.
Videos
videos
Required
Unique direct video variants with their preview images.
Video count
video_count
Required
Number of objects in videos.
Creative cards
cards
Required
Stable per-card copy, link, image, video, and crop data.
Card count
card_count
Required
Number of objects in cards.
Collation ID
collation_id
Required
Meta identifier grouping related creative variants.
Collation count
collation_count
Required
Number of ads Meta reports in the collation.
Currency
currency
Required
Currency for disclosed spend data.
Spend range
spend
Required
Normalized spend range when Meta discloses it.
Reach estimate
reach_estimate
Required
Normalized estimated-reach range when Meta discloses it.
Impressions
impressions
Required
Human-readable impression range when disclosed.
Digitally created media
contains_digital_created_media
Required
Meta-provided digital/AI-created-media disclosure.
Sensitive content
contains_sensitive_content
Required
Meta-provided sensitive-content flag.
Facebook Page verified
page_verified
Required
Tri-state Facebook Page verification. Null means Meta did not expose a verification value; it never means false by default.
Page verification label
page_verification
Required
Unmodified Meta Facebook Page verification label.
Page About
page_about
Required
Advertiser About text from optional detail enrichment.
Instagram username
instagram_username
Required
Linked Instagram username from optional detail enrichment.
Instagram followers
instagram_followers
Required
Linked Instagram follower count from optional detail enrichment.
Instagram verified
instagram_verified
Required
Tri-state Instagram verification; null means Meta did not expose a value.
Payer and beneficiary
payer_beneficiary_data
Required
Meta transparency payer/beneficiary records when disclosed.
Demographic distribution
demographic_distribution
Required
Meta detail payload for age/gender delivery; shape varies by regulation and region.
Regional distribution
regional_distribution
Required
Meta detail payload for geographic delivery; shape varies by regulation and region.
Violation types
violation_types
Required
Meta transparency violation labels.
Targets EU
targets_eu
Required
Whether optional detail data identifies EU targeting.
Detail enriched
detail_enriched
Required
True only when a non-empty optional detail payload was merged.
Creative fingerprint
creative_fingerprint
Required
Stable SHA-256 fingerprint that ignores transient Facebook CDN hosts and signatures.
First seen
first_seen
Optional
First observation timestamp within the selected tracking namespace.
Last seen
last_seen
Optional
Latest observation timestamp within the selected tracking namespace.
New creative
is_new
Optional
True when the archive ID was absent from the prior tracking state.
Creative changed
is_changed
Optional
True when the stable creative fingerprint differs from the prior run.
Previous fingerprint
previous_creative_fingerprint
Optional
Previous stable fingerprint for a changed tracked ad.
Raw Meta result
raw
Optional
Complete source collated result when includeRaw is enabled.
Scraped at
scraped_at
Required
UTC timestamp when the search job completed.