Facebook API
Eleven endpoints for public Facebook pages, posts, reels, groups, events and hashtags — each one a single POST returning structured JSON, with a reel and video downloader built in. No Facebook app, no app review, no login, no scraping stack to keep alive.
50 free credits on signup. No card, no Facebook app, no login.
{ "data": { "page_id": "15087023444", "name": "Nike", "category": "Sportswear shop", "verified": true, "likes": 39560349, "followers": 39000000, "followers_text": "39M", "talking_about_count": 119345, "were_here_count": 18184, "about": "Just Do It.", "website": "http://nike.com/", "profile_pic": "https://scontent.xx.fbcdn.net/v/t39.30808-1/284964043...jpg", "cover_photo": "https://scontent.xx.fbcdn.net/v/t39.30808-6/285211224...png" }, "response_time": 4200, "credits_used": 1, "credits_remaining": 6999}A real captured response from this endpoint. Sign up to run your own.
What is the Scavio Facebook API?
The Scavio Facebook API is a REST API that returns public Facebook data as structured JSON. You POST a public URL — a page, post, reel, group, event or hashtag — to one of 11 endpoints with your API key, and get back profiles, posts, reels with direct MP4 download links, group data, events or comments. No Facebook app, no OAuth flow, and no login credentials, and every call costs 1 credit.
- 11
- endpoints, all live in production
- 1
- credit per call, flat across every endpoint
- 0
- Facebook apps or access tokens required
Start with these four
They cover most of what people build. The full eleven are below.
Reel & video downloader
POST /api/v1/facebook/reelDirect HD and SD MP4 links for any public reel or video, plus title, duration and view count. Dedicated services charge about $7 per thousand for this; here it is 1 credit.
Page profiles
POST /api/v1/facebook/profileFollower and like counts, category, verification, about, website and the page id every other endpoint accepts.
Public groups
POST /api/v1/facebook/groupName, member count and description for a public group, plus its recent top posts — data most APIs simply do not expose.
Events
POST /api/v1/facebook/eventName, description, start and end time, location and host for any public event, as structured JSON.
All 11 Facebook endpoints
Every route is a POST, returns JSON, and takes the same API key. Each successful call costs 1 credit — no per-endpoint surcharge.
| Endpoint | Returns | Credits |
|---|---|---|
Reel / video/api/v1/facebook/reel | One reel or video by URL — direct HD and SD MP4 links, title, duration, view count, owner | 1 |
Page profile/api/v1/facebook/profile | Page id, name, category, verification, follower and like counts, about, website, profile and cover photo | 1 |
Page posts/api/v1/facebook/profile/posts | Recent top posts — text, creation time, reactions by type, comment and share counts, media, permalink | 1 |
Page reels/api/v1/facebook/profile/reels | A page's reels with direct HD and SD MP4 links, thumbnail, duration and play count — bulk downloader | 1 |
Page photos/api/v1/facebook/profile/photos | The page photo grid — photo id, full-size image URL, accessibility caption | 1 |
Post detail/api/v1/facebook/post | One post by URL — author, text, creation time, reactions by type, comment and share counts, media | 1 |
Post comments/api/v1/facebook/post/comments | A post's top comments — id, author, text, reaction count, created time, plus total count | 1 |
Group/api/v1/facebook/group | A public group — id, name, visibility, member count, description | 1 |
Group posts/api/v1/facebook/group/posts | Recent top posts from a public group's feed — same shape as page posts | 1 |
Event/api/v1/facebook/event | An event — name, description, start and end time, location, host, cover photo | 1 |
Hashtag/api/v1/facebook/hashtag | Recent public posts carrying a hashtag — post id, author, text | 1 |
50 free credits on signup covers 50 calls across any mix of endpoints. See plans
Download a Facebook reel in one call
POST a reel or video URL and get back direct MP4 links plus title, view count and duration. The response on the right is a real capture, field names and all.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
reel = client.facebook.reel(
url="https://www.facebook.com/reel/1256772305920939",
)["data"]
print(reel["title"], reel["view_count"])
# Ready-to-download MP4 links (signed URLs expire in hours)
print(reel["video_hd_url"])
print(reel["video_sd_url"]){
"data": {
"video_id": "1256772305920939",
"title": "Why risk it? Because you can. #JustDoIt",
"description": "Why risk it? Because you can. #JustDoIt",
"video_hd_url": "https://video.xx.fbcdn.net/o1/v/t2/f2/m86/AQM0A3Kh...mp4?bitrate=880678&tag=dash_baseline_1_v1",
"video_sd_url": "https://video.xx.fbcdn.net/o1/v/t2/f2/m86/AQMukm3F...mp4",
"thumbnail": "https://scontent.xx.fbcdn.net/v/t51.82787-10/541567930...jpg",
"duration_seconds": 60.05,
"view_count": 949000,
"reaction_count": 3400,
"comment_count": 2331,
"owner": { "id": "100044541544829", "name": "Nike" },
"permalink": "https://www.facebook.com/nike/videos/1256772305920939/",
"creation_time": "2025-09-04T14:02:35.000Z"
},
"response_time": 4820,
"credits_used": 1,
"credits_remaining": 6999
}Why not Meta's own API?
Often you should — if you only need data for pages and accounts you manage or that have authorised your app. For everything else the two are not substitutes.
Facebook Graph API
- Requires a Facebook app, business verification, and review for most permissions
- Returns data for pages you manage or accounts that authorise you — not arbitrary public pages
- Per-user access tokens to issue, refresh and store
- No direct reel or video download links; no public-group or event browsing
Scavio Facebook API
- One API key, issued at signup — no app, no review, no waiting
- Any public page, post, reel, group, event or hashtag by URL
- A reel and video downloader that returns ready-to-fetch MP4 links
- Same key and JSON envelope as 30 other Scavio platforms, at 1 credit a call
Scavio returns publicly available data only, and never authenticates as a Facebook user. For advertising data, see the separate Meta Ad Library API.
What developers build with it
Reel and video downloading at scale
Resolve any public reel or video to direct HD and SD MP4 links and pull a whole page's reels in one call. The signed links are ready to fetch — no player to script, no format to guess. Download inside the run, because the links expire in hours.
reel + profile/reelsPage and competitor monitoring
Run a set of pages on a schedule and diff the results. Follower trend, post cadence, reactions by type and share counts all fall out of two calls, stored in your own database.
profile + profile/postsPublic group research
Read a public group's member count and description, then walk its recent top posts. Community data that most social APIs never expose, returned as clean JSON.
group + group/postsEvent aggregation
Pull name, description, timing, location and host for public events into a calendar, a listings site or a scraper-backed dataset — one POST per event URL.
eventComment mining and sentiment
Fetch a post's detail and its top comments, then feed the text to an LLM for themes, complaints or purchase intent. You get structured author and reaction data, not a wall of HTML.
post + post/commentsAgent tools and RAG pipelines
Point an agent at the remote MCP server and Facebook becomes a callable tool alongside every other Scavio platform — same key, same JSON envelope, no per-platform glue.
MCP + RESTHow to get Facebook data as JSON
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 credits free on signup, with no card required.
- 2
POST a Facebook URL to an endpoint
Send {"url": "https://www.facebook.com/nike"} to https://api.scavio.dev/api/v1/facebook/profile with an Authorization: Bearer header. Every Facebook endpoint is a POST and takes a public Facebook URL — a page, post, reel, group, event or a hashtag tag.
- 3
Read the JSON
The response wraps the data under a data key and adds credits_used and credits_remaining. Reel and video responses include direct MP4 links you can fetch straight away.
Facebook API FAQ
What is the Scavio Facebook API?
+
It is a REST API that returns public Facebook data as structured JSON. Eleven POST endpoints cover page profiles, page posts, page reels, page photos, single post detail, post comments, a reel and video downloader, public groups, group posts, events and hashtags. You authenticate with a Scavio API key and never handle Facebook credentials. This is the organic Facebook surface, separate from the Meta Ad Library API.
Can I download Facebook reels and videos?
+
Yes. The reel endpoint takes a reel, video or watch URL and returns direct HD and SD MP4 links along with the title, duration, view count and owner. The page-reels endpoint does the same in bulk for a whole page. The links are signed and expire within hours, so fetch the file during the same run rather than storing the URL for later. Dedicated download services charge around $7 per thousand for this; on Scavio it is 1 credit per call.
Do I need a Facebook app, access token, or app review?
+
No. Meta's own Graph API requires a Facebook app, business verification, review for most permissions, and per-user access tokens — and it returns data for pages and accounts you manage or that have authorised you, not arbitrary public pages. Scavio needs none of that: sign up, take the key, POST a URL.
Who is this for?
+
Anyone who needs public Facebook data in a structured form rather than a browser tab. Developers embedding it in a product; AI agent builders wiring Facebook in as an MCP or SDK tool; automation engineers running it inside n8n, Zapier or Make; media and marketing teams downloading reels and videos or tracking competitor pages; and researchers aggregating public events, groups and hashtag activity. The API is identical for all of them — what changes is which of the 11 endpoints you call.
How much does a Facebook request cost?
+
Every Facebook endpoint costs 1 credit per successful call — a flat rate, including the reel and video downloader. New accounts get 50 free credits on signup, one time, with no card required. Paid plans start at $30 per month for 7,000 credits, so a Facebook call is a fraction of a cent.
Can it read private groups or private profiles?
+
No. Only data Facebook makes publicly available is returned. Groups are public groups only — a private group is not accessible, and you are not charged when a request cannot be fulfilled. The API never authenticates as a user.
Does the reel and video download URL expire?
+
Yes. The MP4 links Facebook serves are signed and valid for a few hours. Download the file inside the same job that requested it rather than persisting the URL — if you need the video again later, request the reel again.
Does a page feed return the full post history?
+
No, and the page is honest about that. The page-posts and group-posts endpoints return recent top posts, not a complete historical archive. For deep history you would page a post at a time by its permalink. If your use case depends on the last handful of posts and their engagement, that is exactly what these endpoints give you.
Do post comments include every reply?
+
The post-comments endpoint returns the top comments on a post along with the total comment count. It does not walk every nested reply thread. It is the right tool for reading the most visible reactions to a post, not for exhaustively mirroring every comment.
Is this the same as the Meta Ads or Ad Library API?
+
No. Scavio has a separate Meta Ad Library API for advertising data. This Facebook API is the organic side — pages, posts, reels, photos, groups, events and hashtags. They are different products with different endpoints; pick the one that matches the data you need.
Which languages and tools are supported?
+
Official Python (pip install scavio) and JavaScript/TypeScript (npm i scavio) SDKs, a remote MCP server at mcp.scavio.dev for AI agents, and an n8n community node. Any language can call the REST endpoints directly with an HTTP client.
Is scraping Facebook data legal?
+
Scavio returns publicly available data and does not access private content or authenticate as a user. You remain responsible for how you use the data, including compliance with Facebook's terms and with privacy law such as GDPR where personal data is involved. Talk to your own counsel for your specific use case.
Explore more of Scavio
Instagram API
Profiles, posts, reels, stories and comments as JSON.
TikTok API
Profiles, videos, comments and search as JSON.
Threads API
Profiles, posts and replies from Threads.
Meta Ad Library API
Active ads and advertiser data from the Ad Library.
Pricing
Credit packs and plans, with no per-platform surcharge.
MCP server
Every platform as a callable tool for your agents.
Start pulling Facebook data today
50 free credits on signup, no card. Your first request is a POST with a Facebook URL in it.