New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →

Facebook Scraper API: 37 endpoints, structured JSON

Pages, posts, reels, photos, comments, groups, events, Marketplace and the Ad Library: every Facebook endpoint Scrapier ships, each returning typed JSON in the same response envelope. Public data only.

Copy for your AI agent
37Facebook endpoints
1–3credits per successful call
0credits for a failed call
19need no Facebook login
Quick answerScrapier returns typed JSON from 37 Facebook endpoints: Pages, posts, reels, photos, comments, groups, events, Marketplace listings and the Ad Library. Public data only and no proxies; no Facebook login needed. 1 or 3 credits per successful call; failed calls are free. Last verified 9 Nov 2026
Endpoints

What data can I extract with Facebook Scraper?

Pick the data you need. Each endpoint takes a Page name, a link or a keyword and gives you clean JSON back, for 1 or 2 credits per successful call.

Page infoStart here

GET/api/v2/facebook-page/

A public Page's name, category, like count and follower count.

1 credit per callView →Page soon

Page posts

GET/api/v2/facebook-page-posts/

A Page's posts, a page at a time, with text, reaction and comment counts.

1 credit per callView →Page soon

Single post

GET/api/v2/facebook-single-post-scraper/

One post by URL: text, Page name, like, comment and share counts.

1 credit per callView →Page soon

Reels

GET/api/v2/facebook-reels/

A Page's or profile's reels with URL, play count and duration.

1 credit per callView →Page soon

Single reel

GET/api/v2/facebook-single-reel-scraper/

One reel by URL: caption text, owner and play count.

1 credit per callView →Page soon

Photos

GET/api/v2/facebook-photos/

A Page's photos with caption, reaction count, size, owner and post link.

1 credit per callView →Page soon

Single photo

GET/api/v2/facebook-single-photo-scraper/

One photo by URL: image, like, comment and share counts, owner and album.

1 credit per callView →Page soon

Profile albums

GET/api/v2/facebook-profile-albums/

Photos from a profile's albums with caption, thumbnail, owner and album name.

1 credit per callView →Page soon

Video transcript

GET/api/v2/facebook-video-transcript/

Speech-to-text transcript of a Facebook video or reel, with the detected language.

1 credit per callView →Page soon

Comments

GET/api/v2/facebook-comments/

Comments on a public post with author and text; replies can be included.

1 credit per callView →Page soon

Comment replies

GET/api/v2/facebook-comment-replies/

Replies to one comment by its feedback ID: author, text, time and reactions.

1 credit per callView →Page soon

Group info

GET/api/v2/facebook-group-profile/

A public group's name, member count, about text and admins.

1 credit per callView →Page soon

Group posts

GET/api/v2/facebook-group-posts/

Posts in a public group with text, author and reactions, sorted by activity.

1 credit per callView →Page soon

Event search

GET/api/v2/facebook-event-scraper/

Events matching a keyword, with optional location, category and time filters.

1 credit per callView →Page soon

Page events

GET/api/v2/facebook-profile-events/

Upcoming and past events of a Page: name, start time, city and link.

1 credit per callView →Page soon

Marketplace

GET/api/v2/facebook-marketplace/

Marketplace listings from a search or category URL: title, price and location.

1 credit per callView →Page soon

Ad Library

GET/api/v2/facebook-ad-library/

Ads a Page runs, from the Meta Ad Library: archive ID, Page name and ad text.

1 credit per callView →Page soon

Ad Library leads

GET/api/v2/facebook-ad-library-leads/

Advertisers from an Ad Library search, with emails, phones, websites and social links found from their ads.

2 credits per callView →Page soon

Ad transcript

GET/api/v2/facebook-ad-library-transcript/

Transcript of a video ad in the Ad Library, by ad ID or URL.

3 credits per callView →Page soon

Page contact info

INstartUrls

A Page's email, phone, address, website, category, price range, rating and follower counts.

Same API key and JSON envelope

Page search

INcategories

Pages by category and location, each with phone, email, address, website, rating, likes and followers.

Same API key and JSON envelope

People search

ININPUT_URL

Profiles from a people search: name, user ID, profile URL, profile and cover images.

Same API key and JSON envelope

Followers and following

INstartUrls

Pages and profiles an account follows, or that follow it: name, URL, ID and image.

Same API key and JSON envelope

URL to ID

INURLS

The numeric Facebook ID behind a Page, post or group URL, with its Open Graph title and description.

Same API key and JSON envelope

Hashtag posts

INKeywords

Posts under a hashtag with content, media type, like, comment, share and view counts. Takes your own Facebook cookies.

Same API key and JSON envelope

Videos

INhttp_chunk_size

A video's title, description, uploader, duration, upload date, thumbnails and available formats.

Same API key and JSON envelope

Video search

INquery

Videos matching a keyword: title, video URL, duration, owner and how long ago it was posted.

Same API key and JSON envelope

Likes and reactions

INstartUrls

People who reacted to a post: reaction type, name, profile URL and Facebook ID.

Same API key and JSON envelope

Page reviews

INDEFAULT_TARGET_URLS

Reviews on a Page: reviewer, date, recommend flag, review text, like and comment counts.

Same API key and JSON envelope

Group search

INstartUrls

Groups matching a keyword: name, URL, privacy, member count, posts per day and description.

Same API key and JSON envelope

Group members

INgroupUrls

Members of a group: name, profile URL, verified flag and join status. Takes your own Facebook cookies.

Same API key and JSON envelope

Email finder

INkeywords

Public emails found on Facebook pages for a keyword, with the page title, description and URL of each match.

Same API key and JSON envelope

Page emails

INkeywords

Public emails on Facebook Pages that match a keyword, filtered by email domain, with the source URL.

Same API key and JSON envelope

Profile emails

INkeywords

Public emails on Facebook profiles for a keyword and location, with the page title and URL.

Same API key and JSON envelope

Phone number finder

INkeywords

Public phone numbers on Facebook pages for a keyword and country, with the dial code, page title and URL.

Same API key and JSON envelope

Page phone numbers

INkeywords

Public phone numbers on Facebook Pages that match a keyword, with country, dial code and source URL.

Same API key and JSON envelope

Profile phone numbers

INkeywords

Public phone numbers on Facebook profiles for a keyword and country, with the dial code and URL.

Same API key and JSON envelope
Playground

Try Facebook Scraper Live

Pick an endpoint, fill in the input and press Run. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

FacebookPage infoLive

Parameters
+ Run live with your API key
Response
Sample dataCatalog sample, run to see live data
Pricing

How much will scraping Facebook cost?

Every successful call costs 1 or 3 credits, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 3 credits cost $4.74. Scale brings that to $3.59, so 83,333 Facebook calls a month is $299.

See all plans →
PlanPrice / moCredits / moPer 1,000 calls
Free$0Free tier—
Hobby$2915,000$5.80
Pro$7950,000$4.74
Scale$299250,000$3.59
How to

How do I use Facebook Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get Facebook data in a few minutes:

  1. Create a free Scrapier accountSign up with your email and copy your API key.
  2. Pick the endpoint for your dataPages, posts, reels, photos, comments, groups, events, Marketplace or the Ad Library.
  3. Add your inputOne Page name or URL, post URL, group URL or Ad Library link per call.
  4. Page through the resultsList endpoints return next_cursor; pass it back as cursor for the next page.
  5. Or search insteadSend a keyword in queries to facebook-event-scraper to find events.
  6. Run the requestOne GET with your key in the X-API-Key header, or ask your AI agent over MCP.
  7. Save the resultsJSON from the API: store it as is, or flatten it to CSV in a few lines.
Input

Input

Two ways in. Use whichever matches what you already have.

1

By URL

You already have the links to the pages you want.

Page infocopperkettleyqr
Page postsfacebook.com/LombardOlkusz
Single postfacebook.com/nytimes/posts/pfbid02WfD8kRLsDeXyaqA62K1p9eLE1…
Reelsmrbeast
Best forknown pages · paste the link as it is
2

By keyword

You don't know the items yet: find them with a keyword.

Comedy
Event search
  • Python Meetup NYC
Best fordiscovery · plain text, "travel" not "#travel"
Example requests
// GET /api/v2/facebook-page/
{
  "urls": "copperkettleyqr"
}
Send thisParameterAnd you can get
Page name or URLurlsPage details, posts, reels, photos, albums, events and ads
Post, photo or reel URLurlsThat item, its comments, its transcript
Group URLurlsGroup details and the group's posts
Comment feedback IDfeedback_id · cursorReplies to that comment
KeywordqueriesMatching events, with location and time filters

Optional on list endpoints: cursor (pass back next_cursor for the next page). Auth is one header: X-API-Key. Send parameters in the query string (GET) or as a JSON body (POST).

Output

Output

The one thing to know: each data type has its own shape. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/facebook-page/?urls=copperkettleyqr
// one item of data.page · catalog sample
{
  "name": "Meta",
  "category": "Internet company",
  "likes": 142000000,
  "followers": 143000000
}

Every response is {"success": true, "data": {…}}: your input echoed back, the result under its own key (profile, posts, comments…) and next_cursor for the next page.

Use cases

What can you do with Facebook data?

Public Facebook data powers ad research, lead generation, community monitoring, competitor benchmarking and price tracking. Here are five common jobs, and the Facebook scraper endpoints each one chains together.

01

Ad and creative research

See which ads a competitor's Page runs in the Meta Ad Library, read the ad text, and transcribe their video ads. Track new creatives as they appear and compare messaging across brands.

  1. 1ad-library
  2. 2ad-library-transcript
  3. 3page
  4. Creative digest
WeeklySheets, Notion
02

Advertiser lead generation

Run an Ad Library keyword search for your niche, such as plumbers in the US, and get each advertiser with the emails, phones and websites found from their ads. Active advertisers have a budget and a live offer.

  1. 1ad-library-leads
  2. 2page
  3. Lead list
WeeklyCRM, CSV
03

Community and group monitoring

Watch public groups in your market: member count, new posts and the comments under them. Spot recurring questions, complaints and product requests before they show up in support tickets.

  1. 1group-profile
  2. 2group-posts
  3. 3comments
  4. Topic feed
DailyDashboard
04

Competitor Page benchmarking

Compare competitor Pages on likes, followers, posting cadence and reel plays. Read the comments on their best posts to learn what their audience responds to.

  1. 1page
  2. 2page-posts
  3. 3reels
  4. 4comments
  5. Benchmark
WeeklyDashboard
05

Marketplace price tracking

Pull listings from a Marketplace search or category URL on a schedule. Track asking prices and locations for phones, cars or furniture to price your own stock or spot deals.

  1. 1marketplace
  2. Price sheet
DailySheets, database
Features

Features

Facebook Scraper fetches clean, structured Facebook data at low cost: built for ad research, lead generation, community monitoring and AI agents.

Live data, every call

Each request reads Facebook at call time, and most responses say when in scraped_at.

Typed, consistent JSON

Same field names on every call, ready for code, sheets or an LLM, with no HTML to parse.

Lists, page by page

List endpoints return next_cursor; run up to 3 requests in parallel per key.

37 endpoints, one shape

Pages, posts, reels, groups, Marketplace and the Ad Library share the same envelope and auth.

MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

No proxies to manage

Public data only. None of the 19 live endpoints needs a Facebook login or a Meta app.

Maintained for you

When Facebook changes its pages, Scrapier updates the scraper; your field names stay the same.

Pay per successful call

1 or 2 credits per call, however many items the page holds. Failed calls are never billed.

Why Scrapier

Why choose this Facebook Scraper?

The official Meta Graph API reads Pages you manage; reading other public Pages needs extra permissions and app review. Scrapier reads any public Page, post, group, Marketplace search or Ad Library result with one API key, at a price you know before the call runs.

0Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

$3.59Per 1,000 calls on Scale

At 2 credits a call. Flat per-call pricing, no compute units or bandwidth to estimate.

0Setup steps on Facebook

19 live endpoints need no Meta app, Page role, app review or access token.

1 keyFor 35 platforms

The same key and JSON envelope cover Instagram, TikTok, YouTube, LinkedIn and more.

FeatureScrapier Facebook ScraperMeta Graph APIDIY scraper
Whose dataAny public Page, post or groupPages you manage; others after reviewAny public Page
SetupOne API keyMeta app, access tokens, app reviewProxies, browsers, parsers
MaintenanceHandled by ScrapierToken refresh, version upgradesBreaks on layout changes
CostFrom $3.59 per 1,000 callsFree, within Meta's rate limitsServers, proxies and engineering time
AI agentsMCP server includedNoneBuild your own
FAQ

Frequently asked questions

Can I scrape several data types in one call?

No. Each endpoint returns one data type. To get a Page's posts and their comments, call facebook-page-posts then facebook-comments with each post URL, or let an AI agent chain the calls over MCP.

Can I scrape private Facebook profiles or closed groups?

No. Scrapier reads public data only. Private profiles, closed groups and anything behind a friends-only setting are not returned. The live endpoints need no Facebook login.

Why don't some counts match what I see on Facebook?

Two reasons. Scrapier sees the logged-out version of the page, which can show rounded or fewer numbers. And counts are a snapshot from the moment of the call, so they change as people react, comment and share.

How many results can I get?

As many as Facebook shows publicly. List endpoints return a page at a time with next_cursor; pass it back as cursor for the next page. Each page is one call at 1 or 2 credits.

Can I scrape the Facebook Ad Library?

Yes. facebook-ad-library returns the ads a Page runs, facebook-ad-library-leads turns an Ad Library search into advertisers with contact details found from their ads, and facebook-ad-library-transcript transcribes a video ad by its ID.

Can I get comment replies?

Yes. facebook-comments can include replies with include_replies. For a full thread, call facebook-comment-replies with the comment's feedback_id; pass next_cursor back as cursor for more replies.

Is it legal to scrape Facebook?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Some of it can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.

Can I connect Facebook data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.

Can I get Facebook data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Facebook endpoint with search_endpoints and calls it with run_scrape, in Claude Code, Cursor or Windsurf.

Facebook Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

How much does the Facebook scraper cost?

Each Facebook endpoint costs 1 or 2 credits per successful call, however many items the page holds; a Page lookup costs 1 credit. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

What are the Facebook scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

How do I scrape Facebook with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/facebook-page/", headers={"X-API-Key": key}, params={"urls": "MetaPlatformsInc"}, timeout=210). The response is JSON, so read r.json()["data"]["page"] directly; there is no HTML to parse. Loop over your list for more Pages.

Get started

Start pulling Facebook data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.