Get Results
Retrieve scraped data from Facebook Ad Library Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped data from your Facebook Ad Library Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from
pageintegerqueryPage number (default: 1)
Result Fields
ad_archive_idstringUnique Meta Ad Library identifier. Example: 1234567890123456
ad_urlstringDirect Ad Library URL of this ad
ad_idstringMeta's internal ad id
page_idstringNumeric identifier of the Facebook Page
page_namestringName of the Facebook Page running the ad. Example: Apple
page_urlstringURL of the Facebook Page
page_likesintegerNumber of likes of the Page
page_categoriesjsonCategories of the Page
page_profile_picturestringProfile picture of the Page
page_is_deletedbooleanWhether the Page has been deleted
page_owner_namestringLegal name of the confirmed page owner
page_owner_idstringMeta identifier of the confirmed owner
ad_texttextMain body text of the ad creative. Example: Introducing iPhone 17. The most advanced iPhone yet.
headlinetextHeadline of the ad creative
link_descriptiontextLink description shown under the headline
captionstringDisplay link (domain shown on the creative)
cta_textstringLabel of the call-to-action button
cta_typestringType of the call-to-action button
link_urlstringDestination URL of the ad
display_formatstringCreative format: IMAGE, VIDEO, MEME, DCO, DPA, CAROUSEL
bylinestringPaid-for-by byline (political/issue ads)
imagesjsonImages of the creative
videosjsonVideos of the creative
cardsjsonCards of a multi-card creative
is_resharedbooleanWhether the ad reshares an existing post
start_datedatetimeDate and time the ad started running. Example: 2026-09-01T00:00:00Z
end_datedatetimeDate and time the ad stopped running
total_active_timeintegerTotal time active, in seconds
is_activebooleanWhether the ad is currently running. Example: true
publisher_platformsjsonMeta platforms the ad runs on
currencystringCurrency of the spend range
spendstringSpend range as a range string (political ads only)
impressions_textstringImpressions range (political ads only)
impressions_indexintegerMeta's internal impressions index. Example: 4
categoriesjsonAd Library categories
collation_countintegerNumber of ads Meta collated with this one
gated_typestringWhether the ad is eligible or was taken down
contains_sensitive_contentbooleanWhether Meta flags the creative as sensitive
contains_digitally_created_mediabooleanWhether the creative contains AI-generated or altered media
total_adsintegerTotal ads Meta reports for this advertiser
search_keywordstringKeyword the ad was found with
Detail Fields
The following fields require ad_details: true in settings.
payerstringDeclared payer of the ad
beneficiarystringDeclared beneficiary of the ad
targets_eubooleanWhether the ad targets the EU
eu_total_reachintegerTotal EU accounts reached
eu_location_audiencejsonLocations targeted in the EU
eu_gender_audiencestringGender targeted in the EU
eu_age_minintegerLower bound of age range targeted in EU
eu_age_maxintegerUpper bound of age range targeted in EU
eu_age_country_gender_breakdownjsonEU reach broken down by country, age and gender
is_ad_taken_downbooleanWhether Meta has taken the ad down
page_abouttextAbout text of the advertiser's Page
page_aliasstringVanity alias of the advertiser's Page
page_categorystringCategory of the advertiser's Page
page_verificationstringVerification status of the advertiser's Page
instagram_followersintegerNumber of followers of the advertiser's Instagram account
instagram_usernamestringUsername of the advertiser's Instagram account
insights_age_genderjsonShare of impressions by age and gender (political ads)
insights_locationjsonShare of impressions by region (political ads)
page_spend_lifetimejsonLifetime ad spend of the advertiser
violation_typesjsonPolicy violations Meta records on the ad
Response
{"total_results": 1, "data": [{"ad_archive_id": "1234567890123456", "page_name": "Apple", "ad_text": "Introducing iPhone 17. The most advanced iPhone yet.", "is_active": true, "start_date": "2026-09-01T00:00:00Z", "impressions_index": 4}]}