Video Download API
Social Media

Facebook Video Download API

Download public Facebook video posts and Reels. Support for various video qualities and format options.

MP4WebM

Supported Features

  • Public video posts
  • Facebook Reels
  • Watch videos
  • HD quality downloads
  • Page videos
  • Group videos (public)

Quick start example

Download Facebook videos with a simple API call. Here's how to get started:

download-facebook-video.sh
curl --request GET \
--url 'https://api.endpoint-hidden-contact-us.com/v1/video/download?query=https://facebook.com/watch?v=123' \
--header 'x-api-key: YOUR_API_KEY'
Response200 OK
{
"job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Use the job_id to check the download status via the Jobs endpoint.

Job completed response

What you get when the download is ready

Once the job completes, retrieve the full response using the job_id. Here's an example of a completed Facebook video download:

GET /api/jobs/{job_id}
curl -X GET "https://api.endpoint-hidden-contact-us.com/v1/jobs/019b550b-da47-4d31-b764-242dfb16944e" \
-H "Authorization: Bearer YOUR_API_KEY"
Completed Job Response200 OK
{
"id": "019b550b-da47-4d31-b764-242dfb16944e",
"success": true,
"status": "CompletedJob",
"endpoint": "/api/video/download",
"created_at": "2025-12-25T10:26:38.790691Z",
"started_at": "2025-12-25T10:26:38.794956Z",
"duration_ms": 19677,
"args": {
"query": "https://www.facebook.com/video/example",
"video_format": "mp4",
"download_type": "video",
"video_quality": "best",
"async": false
},
"result": {
"metadata": {
"title": "Example Facebook Video Title",
"duration": 127,
"thumbnail": "https://example.com/thumbnail.jpg",
"resolution": "1920x1080",
"view_count": 125430,
"like_count": 8542,
"channel_id": "xxxxxx",
"description": "Video description from Facebook...",
"upload_date": 1760832000
},
"response": "https://s3.domain.com/videos/00b2b9fb-0d26-468b-8c14-d07c22161992.mp4"
}
}

result.response

Direct S3 URL to download the processed video file. Cached and ready for immediate access.

result.metadata

Rich metadata including title, duration, thumbnails, view counts, and more.

duration_ms

Processing time in milliseconds. Most jobs complete in under 30 seconds.

status

Job status: PendingJob, RunningJob, or CompletedJob.

Why use our Facebook video download API

Built for reliability, speed, and ease of integration

Live processing

Real-time extraction of Facebook videos with async job tracking

High reliability

99.9% uptime with automatic failover and error handling

Multiple formats

Support for MP4, WebM with quality options

Start downloading Facebook videos today

Get your API key and start integrating our Facebook video download API into your application.