Facebook Details API

Get full Facebook video metadata — title, views, likes, duration, and more.

What is the Facebook Details API?

The Facebook Details API lets you fetch full metadata and engagement stats from Facebook with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.

What you get

Title, description, and thumbnail URLs
View, like, comment, and share counts
Duration, publish date, and author handle
Stable IDs for joining with other endpoints

Example request

curl "https://api.captapi.com/v1/facebook/details?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1234567890123456" \
  -H "Authorization: Bearer capt_live_..."

Example response

{
  "success": true,
  "cached": false,
  "creditsUsed": 1,
  "data": {
    "id": "dQw4w9WgXcQ",
    "title": "Example video",
    "author": "@creator",
    "views": 1842203,
    "likes": 95210,
    "comments": 4123,
    "durationSec": 213,
    "publishedAt": "2024-11-02T10:00:00Z"
  }
}

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Video

idStable platform ID for the video.
titleVideo title.
authorCreator handle or channel name.
durationSecVideo length in seconds.
publishedAtPublish date (ISO 8601).

Engagement

viewsTotal view count.
likesTotal like count.
commentsTotal comment count.

Parameters

Name	Type	Required	Description
url	string	Yes	Public Facebook video URL.

Authentication: send your key as Authorization: Bearer capt_live_.... Each successful call costs 1 credit; cached responses (24h) are free.

How it works

1. Sign up — get 100 free credits, no card required.
2. Create a key from your dashboard.
3. Send one request to /v1/facebook/details and parse the JSON response.

Use cases

Analytics

Track views, likes, and engagement over time.

Competitor Monitoring

Benchmark the performance of other creators.

Dashboards

Power reporting and BI with real metadata.

Content Curation

Filter and rank videos by performance.

Frequently asked questions

What does the Facebook Details API do?+

The Facebook Details API lets you fetch full metadata and engagement stats from a public Facebook video using one GET request to /v1/facebook/details. It returns clean JSON — no OAuth or scraping setup required.

How many credits does the Facebook Details API cost?+

Each successful call costs 1 credit. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.

Do I need a Facebook API key or OAuth?+

No. A single Captapi key works across YouTube, TikTok, Instagram, and Facebook. We handle proxies, rate limits, retries, and authentication for you.

Is the Facebook Details API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.

More Facebook APIs

Facebook Transcript API Facebook Summarizer API Facebook Comments API Facebook Page Details API

Ready to use the Facebook Details API?

Get started free