primaryText
Optional
Main ad body text.
Facebook Ads Competitor Intelligence
Pricing
from $50.00 / 1,000 results
Turn public Meta Ad Library data into structured competitor advertising intelligence: ad discovery, creative type, CTA, offer detection, ad age, landing pages, advertiser statistics, deduplication and historical change detection. Deterministic, no AI (V1).
advertiserName
Optional
Normalized advertiser (Page) name as displayed in the Ad Library.
advertiserPageName
Optional
Raw Page name as displayed in the Ad Library.
advertiserPageId
Optional
Facebook Page ID of the advertiser.
advertiserPageUrl
Optional
Public URL of the advertiser's Facebook Page.
instagramHandle
Optional
Instagram handle shown for the advertiser, if any.
adId
Optional
Ad Library ID (ad_archive_id).
adUrl
Optional
Public Ad Library URL for this ad.
collationId
Optional
Meta grouping ID for ads sharing the same creative, if provided.
collationCount
Optional
Number of ad versions Meta groups under this creative, if provided.
platforms
Required
Placements with evidence in the source data (Facebook, Instagram, Messenger, Audience Network, Threads).
status
Required
Normalized ad status.
sourceStatus
Optional
Original status value from the source.
startDate
Optional
ISO-8601 date the ad started running.
endDate
Optional
ISO-8601 date the ad stopped running, if available.
daysRunning
Optional
Days between start and end (or now for active ads).
adAgeDays
Optional
Days since the ad started running.
adAgeCategory
Required
NEW 0–7 days, RECENT 8–30, ESTABLISHED 31–90, LONG_RUNNING 91+. Only describes duration, not performance.
primaryText
Optional
Main ad body text.
headline
Optional
Ad headline / link title.
description
Optional
Link description text.
caption
Optional
Link caption (usually the display domain).
callToAction
Optional
CTA label as shown in the ad.
normalizedCallToAction
Required
Normalized CTA category (SHOP_NOW, LEARN_MORE, SIGN_UP, ... OTHER, UNKNOWN).
creativeType
Required
Creative format derived from the source display format and media.
sourceDisplayFormat
Optional
Original display format value from the source.
imageUrls
Required
Public image URLs (only when includeMedia is true).
videoUrls
Required
Public video URLs (only when includeMedia is true).
thumbnailUrls
Required
Public video preview / thumbnail URLs (only when includeMedia is true).
cardCount
Optional
Number of carousel cards, if applicable.
cards
Optional
Per-card text, CTA and link data for carousel creatives.
offerDetected
Required
Whether a rule-based offer pattern was found in the ad text.
offerType
Optional
DISCOUNT, PRICE, FREE, BOGO, FINANCING, SALE, PROMOTION or null.
offerValue
Optional
The extracted value (e.g. 20%, R999, $99).
offerText
Optional
The exact matched text fragment.
urgencyDetected
Required
Whether urgency wording (limited time, ends soon, ...) was found.
landingPageUrl
Optional
Landing page URL exposed by the ad (Facebook redirect wrappers removed).
finalUrl
Optional
URL after following redirects (only when includeLandingPage is true).
landingPageDomain
Optional
Registrable host of the landing page.
pageTitle
Optional
Landing page .
metaDescription
Optional
Landing page meta description.
httpStatus
Optional
Final HTTP status of the landing page request.
redirectCount
Optional
Number of redirects followed.
landingPageType
Required
Heuristic landing page classification based on URL path and title signals.
creativeFingerprint
Optional
Deterministic hash of advertiser + text + media + landing URL.
textFingerprint
Optional
Deterministic hash of normalized ad text.
mediaFingerprint
Optional
Deterministic hash of media URL identifiers, when media is present.
changeStatus
Optional
Historical comparison result (null when disabled or no previous snapshot).
disclaimer
Optional
Disclaimer / 'Paid for by' label if publicly displayed.
fundingEntity
Optional
Funding entity / byline if publicly displayed.
pageCategories
Optional
Page categories shown in the Ad Library.
pageLikeCount
Optional
Page like count shown in the Ad Library, if any.
searchTerm
Optional
Search term that discovered this ad (null for page-ID searches).
searchPageId
Optional
Page ID search that discovered this ad.
country
Required
Country filter used for the search.
scrapedAt
Required
ISO-8601 timestamp of extraction.
error
Optional
Non-fatal error message for this ad, if any.
errorType
Optional
Error category (TIMEOUT, HTTP_ERROR, INVALID_URL, PARSE_ERROR, NETWORK_ERROR).
errorStage
Optional
Pipeline stage where the error occurred (e.g. landing-page-enrichment).