Skip to content
Examples

Get Results

Retrieve scraped data from Facebook Ad Library Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Facebook Ad Library Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

pageintegerquery

Page number (default: 1)

Result Fields

ad_archive_idstring

Unique Meta Ad Library identifier. Example: 1234567890123456

ad_urlstring

Direct Ad Library URL of this ad

ad_idstring

Meta's internal ad id

page_idstring

Numeric identifier of the Facebook Page

page_namestring

Name of the Facebook Page running the ad. Example: Apple

page_urlstring

URL of the Facebook Page

page_likesinteger

Number of likes of the Page

page_categoriesjson

Categories of the Page

page_profile_picturestring

Profile picture of the Page

page_is_deletedboolean

Whether the Page has been deleted

page_owner_namestring

Legal name of the confirmed page owner

page_owner_idstring

Meta identifier of the confirmed owner

ad_texttext

Main body text of the ad creative. Example: Introducing iPhone 17. The most advanced iPhone yet.

headlinetext

Headline of the ad creative

link_descriptiontext

Link description shown under the headline

captionstring

Display link (domain shown on the creative)

cta_textstring

Label of the call-to-action button

cta_typestring

Type of the call-to-action button

link_urlstring

Destination URL of the ad

display_formatstring

Creative format: IMAGE, VIDEO, MEME, DCO, DPA, CAROUSEL

bylinestring

Paid-for-by byline (political/issue ads)

imagesjson

Images of the creative

videosjson

Videos of the creative

cardsjson

Cards of a multi-card creative

is_resharedboolean

Whether the ad reshares an existing post

start_datedatetime

Date and time the ad started running. Example: 2026-09-01T00:00:00Z

end_datedatetime

Date and time the ad stopped running

total_active_timeinteger

Total time active, in seconds

is_activeboolean

Whether the ad is currently running. Example: true

publisher_platformsjson

Meta platforms the ad runs on

currencystring

Currency of the spend range

spendstring

Spend range as a range string (political ads only)

impressions_textstring

Impressions range (political ads only)

impressions_indexinteger

Meta's internal impressions index. Example: 4

categoriesjson

Ad Library categories

collation_countinteger

Number of ads Meta collated with this one

gated_typestring

Whether the ad is eligible or was taken down

contains_sensitive_contentboolean

Whether Meta flags the creative as sensitive

contains_digitally_created_mediaboolean

Whether the creative contains AI-generated or altered media

total_adsinteger

Total ads Meta reports for this advertiser

search_keywordstring

Keyword the ad was found with

Detail Fields

The following fields require ad_details: true in settings.

payerstring

Declared payer of the ad

beneficiarystring

Declared beneficiary of the ad

targets_euboolean

Whether the ad targets the EU

eu_total_reachinteger

Total EU accounts reached

eu_location_audiencejson

Locations targeted in the EU

eu_gender_audiencestring

Gender targeted in the EU

eu_age_mininteger

Lower bound of age range targeted in EU

eu_age_maxinteger

Upper bound of age range targeted in EU

eu_age_country_gender_breakdownjson

EU reach broken down by country, age and gender

is_ad_taken_downboolean

Whether Meta has taken the ad down

page_abouttext

About text of the advertiser's Page

page_aliasstring

Vanity alias of the advertiser's Page

page_categorystring

Category of the advertiser's Page

page_verificationstring

Verification status of the advertiser's Page

instagram_followersinteger

Number of followers of the advertiser's Instagram account

instagram_usernamestring

Username of the advertiser's Instagram account

insights_age_genderjson

Share of impressions by age and gender (political ads)

insights_locationjson

Share of impressions by region (political ads)

page_spend_lifetimejson

Lifetime ad spend of the advertiser

violation_typesjson

Policy violations Meta records on the ad

Response

200
{"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}]}