# Facebook Scraper API: 37 Endpoints, Typed JSON | Scrapier (https://scrapier.io/scrapers/facebook/)

> Facebook scraper API with 37 endpoints: Pages, posts, groups, comments, Marketplace and Ad Library as typed JSON. 1 or 2 credits per call. Get a free API key.

Last updated: 2026-11-10

## 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.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**37**Facebook endpoints

**1–3**credits per successful call

**0**credits for a failed call

**19**need 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 call_View →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 call_View →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 call_View →Page soon_

### Reels

`**GET**/api/v2/facebook-reels/`

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

1 credit per call_View →Page soon_

### Single reel

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

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

1 credit per call_View →Page soon_

### Photos

`**GET**/api/v2/facebook-photos/`

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

1 credit per call_View →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 call_View →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 call_View →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 call_View →Page soon_

### Comments

`**GET**/api/v2/facebook-comments/`

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

1 credit per call_View →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 call_View →Page soon_

### Group info

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

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

1 credit per call_View →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 call_View →Page soon_

### Event search

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

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

1 credit per call_View →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 call_View →Page soon_

### Marketplace

`**GET**/api/v2/facebook-marketplace/`

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

1 credit per call_View →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 call_View →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 call_View →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 call_View →Page soon_

### Page contact info

`**IN**startUrls`

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

Same API key and JSON envelope

### Page search

`**IN**categories`

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

Same API key and JSON envelope

### People search

`**IN**INPUT_URL`

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

Same API key and JSON envelope

### Followers and following

`**IN**startUrls`

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

Same API key and JSON envelope

### URL to ID

`**IN**URLS`

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

`**IN**Keywords`

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

`**IN**http_chunk_size`

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

Same API key and JSON envelope

### Video search

`**IN**query`

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

`**IN**startUrls`

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

Same API key and JSON envelope

### Page reviews

`**IN**DEFAULT_TARGET_URLS`

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

Same API key and JSON envelope

### Group search

`**IN**startUrls`

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

Same API key and JSON envelope

### Group members

`**IN**groupUrls`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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.

Facebook**Page info**Live

Platform

Endpoint

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 →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $5.80 |
| Pro | $79 | 50,000 | $4.74 |
| Scale | $299 | 250,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:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**Pages, posts, reels, photos, comments, groups, events, Marketplace or the Ad Library.
3. **Add your input**One Page name or URL, post URL, group URL or Ad Library link per call.
4. **Page through the results**List endpoints return `next_cursor`; pass it back as `cursor` for the next page.
5. **Or search instead**Send a keyword in `queries` to `facebook-event-scraper` to find events.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON 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 info`copperkettleyqr`

Page posts`facebook.com/LombardOlkusz`

Single post`facebook.com/nytimes/posts/pfbid02WfD8kRLsDeXyaqA62K1p9eLE1…`

Reels`mrbeast`

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 this | Parameter | And you can get |
| --- | --- | --- |
| Page name or URL | `urls` | Page details, posts, reels, photos, albums, events and ads |
| Post, photo or reel URL | `urls` | That item, its comments, its transcript |
| Group URL | `urls` | Group details and the group's posts |
| Comment feedback ID | `feedback_id` · `cursor` | Replies to that comment |
| Keyword | `queries` | Matching 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. _1_ad-library
2. _2_ad-library-transcript
3. _3_page
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. _1_ad-library-leads
2. _2_page
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. _1_group-profile
2. _2_group-posts
3. _3_comments
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. _1_page
2. _2_page-posts
3. _3_reels
4. _4_comments
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. _1_marketplace
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.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

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

**$3.59**Per 1,000 calls on Scale

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

**0**Setup steps on Facebook

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

**1 key**For 35 platforms

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

| Feature | Scrapier Facebook Scraper | Meta Graph API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public Page, post or group | Pages you manage; others after review | Any public Page |
| Setup | One API key | Meta app, access tokens, app review | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | Token refresh, version upgrades | Breaks on layout changes |
| Cost | From $3.59 per 1,000 calls | Free, within Meta's rate limits | Servers, proxies and engineering time |
| AI agents | MCP server included | None | Build 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.

Other platforms

## You might also like

[### Instagram

20 endpoints](https://scrapier.io/scrapers/instagram/)[### Threads

6 endpoints](https://scrapier.io/scrapers/threads/)[### YouTube

17 endpoints](https://scrapier.io/scrapers/youtube/)[### TikTok

29 endpoints](https://scrapier.io/scrapers/tiktok/)[### LinkedIn

8 endpoints](https://scrapier.io/scrapers/linkedin/)[### X (Twitter)

6 endpoints](https://scrapier.io/scrapers/x-twitter/)

Get started

## Start pulling Facebook data in 60 seconds

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

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 37 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/facebook/
Site index for AI agents: https://scrapier.io/llms.txt
