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 ClaudeCursorChatGPTWindsurfClaudeyour 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.
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.
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
}
// GET /api/v2/facebook-page-posts/?urls=https://www.facebook.com/LombardOlkusz// one item of data.posts · catalog sample
{
"post_id": "p-1",
"text": "Announcing new features...",
"reactions": 5000,
"comments": 230
}
// GET /api/v2/facebook-reels/?urls=mrbeast// one item of data.reels · catalog sample
{
"id": "r-1",
"url": "https://www.facebook.com/reel/123",
"play_count": 25000,
"duration": 30
}
// GET /api/v2/facebook-photos/?urls=IamSRK// one item of data.photos · catalog sample
{
"facebookUrl": "https://www.facebook.com/IamSRK",
"id": "YXBwX2l0ZW06MTAwMDQ0MTg1NDI4MjYxOjIzMDUyNzI3MzI6NTo6MTY2ODcxNDQyMTI3ODA1Ng==",
"image": "https://scontent.fdac8-1.fna.fbcdn.net/v/t39.30808-6/847385355_n.jpg",
"url": "https://www.facebook.com/photo/?fbid=1668714421278056&set=a.271269304355915",
"dataType": "photo",
"ocrText": "May be an image of one or more people, beard, fire and text",
"facebookId": "YXBwX2NvbGxlY3Rpb246cGZiaWQwNjhpYWhmcFBwU3VTSmVkdnM0OGlkZVFDa3dON1NiaEQx",
"pageAdLibrary": {
"is_business_page_active": false,
"id": "197997523559852"
},
"inputUrl": "https://www.facebook.com/IamSRK",
"photoId": "1668714421278056",
"postId": "1668714507944714",
"postUrl": "https://www.facebook.com/IamSRK/posts/pfbid0zzS22EiuY1yoBrRfqUhQaPcr3RMx6nXp3yWaYkw7nLf57i16C1k2NmuZ9ZGqPyNvl",
"caption": "A new chapter. A new perspective.",
"timestamp": "2026-10-13T07:12:08+00:00",
"createdTime": 1791875528,
"width": 1638,
"height": 2048,
"ownerId": "100044185428261",
"ownerName": "Shah Rukh Khan",
"reactionsCount": 10000,
"albumId": "271269304355915",
"scraped_at": "2026-10-13T09:00:00Z",
"position": 1
}
// GET /api/v2/facebook-comments/?urls=https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkis// one item of data.comments · catalog sample
{
"id": "c-1",
"comment_id": "abc",
"text": "Great post!",
"author": "User1"
}
// GET /api/v2/facebook-group-posts/?urls=https://www.facebook.com/groups/535363634111893// one item of data.posts · catalog sample
{
"post_id": "p-1",
"text": "Hello group",
"author": "Admin",
"reactions": 5
}
// GET /api/v2/facebook-ad-library/?urls=https://www.facebook.com/ZapierApp// one item of data.ads · catalog sample
{
"id": "ad-1",
"ad_archive_id": "1234567890",
"page_name": "Example",
"ad_text": "..."
}
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.
1ad-library
2ad-library-transcript
3page
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.
1ad-library-leads
2page
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.
1group-profile
2group-posts
3comments
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.
1page
2page-posts
3reels
4comments
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.
1marketplace
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.
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.
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.