Skip to main content
GET
Get Results
Retrieve scraped data from your Facebook Ad Library Scraper runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

string
required
Hash of the squid to get results from
integer
Page number (default: 1)

Result Fields

string
Unique Meta Ad Library identifier. Example: 1234567890123456
string
Direct Ad Library URL of this ad
string
Meta’s internal ad id
string
Numeric identifier of the Facebook Page
string
Name of the Facebook Page running the ad. Example: Apple
string
URL of the Facebook Page
integer
Number of likes of the Page
json
Categories of the Page
string
Profile picture of the Page
boolean
Whether the Page has been deleted
string
Legal name of the confirmed page owner
string
Meta identifier of the confirmed owner
text
Main body text of the ad creative. Example: Introducing iPhone 17. The most advanced iPhone yet.
text
Headline of the ad creative
Link description shown under the headline
string
Display link (domain shown on the creative)
string
Label of the call-to-action button
string
Type of the call-to-action button
Destination URL of the ad
string
Creative format: IMAGE, VIDEO, MEME, DCO, DPA, CAROUSEL
string
Paid-for-by byline (political/issue ads)
json
Images of the creative
json
Videos of the creative
json
Cards of a multi-card creative
boolean
Whether the ad reshares an existing post
datetime
Date and time the ad started running. Example: 2026-09-01T00:00:00Z
datetime
Date and time the ad stopped running
integer
Total time active, in seconds
boolean
Whether the ad is currently running. Example: true
json
Meta platforms the ad runs on
string
Currency of the spend range
string
Spend range as a range string (political ads only)
string
Impressions range (political ads only)
integer
Meta’s internal impressions index. Example: 4
json
Ad Library categories
integer
Number of ads Meta collated with this one
string
Whether the ad is eligible or was taken down
boolean
Whether Meta flags the creative as sensitive
boolean
Whether the creative contains AI-generated or altered media
integer
Total ads Meta reports for this advertiser
string
Keyword the ad was found with

Detail Fields

The following fields require ad_details: true in settings.
string
Declared payer of the ad
string
Declared beneficiary of the ad
boolean
Whether the ad targets the EU
integer
Total EU accounts reached
json
Locations targeted in the EU
string
Gender targeted in the EU
integer
Lower bound of age range targeted in EU
integer
Upper bound of age range targeted in EU
json
EU reach broken down by country, age and gender
boolean
Whether Meta has taken the ad down
text
About text of the advertiser’s Page
string
Vanity alias of the advertiser’s Page
string
Category of the advertiser’s Page
string
Verification status of the advertiser’s Page
integer
Number of followers of the advertiser’s Instagram account
string
Username of the advertiser’s Instagram account
json
Share of impressions by age and gender (political ads)
json
Share of impressions by region (political ads)
json
Lifetime ad spend of the advertiser
json
Policy violations Meta records on the ad

Response

200