Facebook Video Download API
One HTTP call turns a public Facebook Reel or video URL into direct MP4 links plus metadata. Share links from the Facebook app are expanded for you — no Graph API app review.
Also try it instantly on the homepage trial box — no login needed.
curl -X POST https://api.soclip.dev/v1/media \
-H "Authorization: Bearer sc_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.facebook.com/reel/1748315796592676/"}'{
"success": true,
"credits_used": 2,
"credits_remaining": 498,
"data": {
"source": "facebook",
"title": "Video title from the platform",
"duration": 15,
"thumbnail": "https://...",
"author": "Channel / creator name",
"medias": [
{ "label": "HD", "type": "video", "ext": "mp4", "quality": "hd", "url": "https://..." },
{ "label": "SD", "type": "video", "ext": "mp4", "quality": "sd", "url": "https://..." }
]
}
}Full API reference: /docs · Plain-text docs for AI agents: /llms.txt
Reels, videos and share links
facebook.com/reel/…, watch links, fb.watch and the /share/r/… links the mobile app copies all go to the same endpoint.
HD and SD MP4
When Facebook serves both renditions you get both, HD first, each with a quality tag.
Downloadable links
Raw Facebook media URLs often refuse direct downloads. soclip returns links served through its own download endpoint, so a plain curl or browser download works.
Pay only for successes
Private, deleted or region-locked videos return a clear error and the credits are refunded automatically.
$0.002 per extraction (2 credits). 500 free credits on signup — credits never expire.
See Pricing →Facebook Video Download API FAQ
Does Facebook have an official video download API?
The Graph API only exposes video files for pages you manage, after app review. There is no endpoint that turns a public Reel URL into a file. soclip does that in one request.
Which Facebook URLs are supported?
Public Reels (facebook.com/reel/…), video and watch URLs, fb.watch short links and app share links (facebook.com/share/r/… and /share/v/…).
Why did a Facebook video fail?
Videos that are private, limited to friends or groups, deleted, or blocked in some regions cannot be fetched. These calls return an error and are not charged.
Is downloading Facebook videos legal?
Only download videos you have the right to use — your own content or content you have permission for — and respect the platform's terms. The API returns media links; what you do with them is your responsibility.
How much does it cost?
Each media extraction costs 2 credits ($0.002). New accounts get 500 free credits — enough for 250 extractions. Credits never expire.