API Documentation

Complete reference for the GetVidFB Facebook Video & Story API v1.

🔐 Authentication

All API requests require an API key. Include your key in the request header:

X-API-Key: gvfb_your_api_key_here

You can get your API key by creating a free account and visiting your dashboard.

🌐 Base URL

https://getvidfb.com/api/v1

📡 Endpoints

Get Video / Story / Reel Info

GET /api/v1/video-info

Extracts video, story, or reel data from a Facebook URL. The API automatically detects the content type.

Query Parameters

Parameter	Type	Required	Description
`url`	string	Required	The full Facebook URL (video, story, or reel)

Request Headers

Header	Required	Description
`X-API-Key`	Required	Your API key from the dashboard

Example Request

curl -X GET \
  "https://getvidfb.com/api/v1/video-info?url=https://www.facebook.com/watch?v=123456789" \
  -H "X-API-Key: gvfb_your_api_key_here"

Success Response (200)

Video Response:

{
  "success": true,
  "source": "FB-Vid",
  "title": "Video title here",
  "description": "Video description...",
  "thumbnail": "https://thumbnail-url.jpg",
  "links": {
    "sd": "https://sd-video-url.mp4",
    "hd": "https://hd-video-url.mp4",
    "audio": "https://audio-url.mp3"
  },
  "timestamp": "2026-03-29T07:00:00.000Z"
}

Story Response:

{
  "success": true,
  "source": "FB-Story",
  "title": "Story title",
  "items": [
    {
      "title": "Story title _ 00",
      "thumbnail": "https://photo-url.jpg",
      "sd": "https://sd-url.mp4",
      "hd": "https://hd-url.mp4",
      "audio": "https://audio-url.mp3"
    }
  ],
  "timestamp": "2026-03-29T07:00:00.000Z"
}

❌ Error Responses

401 — Unauthorized

{
  "success": false,
  "error": "Invalid or missing API key."
}

400 — Bad Request

{
  "success": false,
  "error": "The 'url' query parameter is required."
}

429 — Rate Limit Exceeded

{
  "success": false,
  "error": "Daily request limit exceeded. Upgrade your plan for more.",
  "limit": 50,
  "used": 50
}

500 — Server Error

{
  "success": false,
  "error": "Failed to extract data. The URL may be invalid or the content is private."
}

⏱️ Rate Limits

Plan	Daily Limit	Rate
Free	50 requests	5 req/min
Starter ($9.99/mo)	500 requests	30 req/min
Pro ($49.99/mo)	5,000 requests	60 req/min
Business ($149.99/mo)	20,000 requests	120 req/min

Limits reset at midnight UTC. Check the X-RateLimit-Remaining response header to monitor usage.

🔗 Supported URL Formats

https://www.facebook.com/watch?v=123456789
https://www.facebook.com/user/videos/123456789
https://www.facebook.com/reel/123456789
https://www.facebook.com/stories/123456789
https://www.facebook.com/share/v/abcdef
https://m.facebook.com/... (mobile URLs auto-converted)
https://web.facebook.com/... (web URLs auto-converted)

📦 Code Examples

Node.js / JavaScript

const response = await fetch(
  `https://getvidfb.com/api/v1/video-info?url=${encodeURIComponent(fbUrl)}`,
  { headers: { 'X-API-Key': 'YOUR_KEY' } }
);
const data = await response.json();

Python

import requests

r = requests.get(
    "https://getvidfb.com/api/v1/video-info",
    params={"url": fb_url},
    headers={"X-API-Key": "YOUR_KEY"}
)
data = r.json()

PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,
    "https://getvidfb.com/api/v1/video-info?url=" . urlencode($fbUrl));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);