SocialScrape
Get early access

Facebook API

23 endpoints for Facebook, one JSON shape. Lists page with a cursor. Failed requests are free.

Profiles

Facebook profile or page

A public page: category, address, email, phone, website, services, price range, rating.

Posts and videos

Facebook profile posts

Public posts of a page, 3 a page: text, reactions, comments, time, video URLs and top comments.

Facebook profile reels

Up to 10 reels a page: id, URL, view count.

Facebook profile photos

Photos from a page's Photos tab (type "image"): id, caption, image URL and size.

Facebook post details

One public post or reel.

Facebook public group posts

Posts of a public group, 3 a page, chronological by default.

Comments

Facebook post comments

Comments on a post or reel: text, time, reply and reaction counts, author and attachments.

Facebook comment replies

Replies to one comment.

Transcripts

Facebook Ad Library ad transcript

Transcript of a video ad.

Facebook video transcript

Transcript of a video post or reel: existing captions first, otherwise AI transcription of the audio.

Search and trends

Facebook Ad Library search

Search the Meta Ad Library by keyword.

Facebook Ad Library advertiser search

Advertisers matching a name: Ad Library page id, category, likes, verification and Instagram details.

Facebook video search

Facebook's own public video search, logged out: matching videos and reels in Facebook's ranking.

Facebook Marketplace location search

Marketplace cities and areas matching a name.

Facebook Marketplace search

Search Marketplace by keyword, or browse a category without a keyword.

Facebook Events search

Events matching a name or description, as facebook.com/events/search shows them to a logged-out.

Ads

Facebook Ad Library ads by page

The ads a company runs, by Ad Library page id or by company name.

Facebook Ad Library ad details

One ad by id or URL: page, status, dates and the snapshot.

Shops and products

Facebook Marketplace listing

One listing: title, description, price, location, condition, photos, seller and availability flags.

Other data

Facebook page events

Public events of a page.

Facebook public group

What a public group's About page shows.

Facebook city events

The events Facebook lists for a city, from its public explore page.

Facebook event details

Returns id, url, title, description, starts_at.

Tutorials

How to scrape Facebook Ad Library search

Nine languages, step by step.

How to scrape Facebook Ad Library ads by page

Nine languages, step by step.

How to scrape Facebook Ad Library ad details

Nine languages, step by step.

How to scrape Facebook Ad Library ad transcript

Nine languages, step by step.

How to scrape Facebook Ad Library advertiser search

Nine languages, step by step.

How to scrape Facebook profile or page

Nine languages, step by step.

Questions

What does the Facebook API cost?

Most requests cost 1 credit, and transcripts have their own rule; each endpoint page states it. New accounts get 100 free credits. See pricing.

Does it need a Facebook login?

No. SocialScrape reads public, logged-out data and you never send a platform password.

Is it live?

The endpoints are in beta: built and tested against recorded responses, with early access keys going out first. Ask for a key.