Skip to content

Facebook Post API

GET https://api.fetchproof.com/v1/facebook/post

Get a public Facebook reel or video by URL (/reel/, /watch?v=, /<page>/videos/ and share links). Returns post_id, like_count (all reactions), comment_count, share_count, description, creation_time, the video's SD and HD URLs, author and sound. view_count is included only when the public page shows it; logged-out reel pages usually do not. shared_post_id and shared_post_url are null. Posts that Facebook only shows to signed-in visitors fail at 0 credits.

Default cost: 1 credit per call 0 credits on error & cache hits
Code & Payload

Quick start

Open interactive playground in Docs ↗

cURL

curl --request GET 'https://api.fetchproof.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1535656380759655");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "post_id": "25118307061088489",
  "shared_post_id": null,
  "shared_post_url": null,
  "is_paid_partnership": false,
  "like_count": 8706,
  "comment_count": 98,
  "share_count": 440,
  "description": "Air Fryer Chocolate Cake \n\n100% f*cks, super simple and comes out gooey in the middle. 🍆 \n\n👨‍🍳 Ingredients:\n✅ 1 large banana – 100 g (3.5 oz)\n✅ 80 g vanilla YoPro yogurt (2.8 oz / ⅓ cup)\n✅ 15 g Cadbury Bournville cocoa (0.5 oz / 1 tbs...",
  "creation_time": "2025-09-18T06:30:18.000Z",
  "feedback_id": "ZmVlZGJhY2s6cGZiaWQwanpHTXJDUkp1U2pFdHdRUnJQMVI3M0x5Q2RhVm9MMjNkWXVKVmhhY1drOHEyc3lYRXozczVuanp2ZnRROUZnY2w=",
  "url": "https://www.facebook.com/reel/1535656380759655",
  "image_url": null,
  "video": {
    "id": "1535656380759655",
    "sd_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m86/AQP26h3cF_x-zEqNiL22tbkM8vRrcYmq5O3IHLNA-ibZVh613E_-SBR25nd0qXxlNWxOfbRGXJx4jBskIIfW0H5CKtNCb_db46moK5c.mp4",
    "hd_url": "https://video-iad6-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQM7Ez8-u4M80Wm9tTwV9bEH6kAzzPN5-OItb-_hFmYJ8FCWTovPjH6rggWTTISlhmy7nFZivFjpRPRpRVDlHVVdyvdGJvwkMi6Nd4Y.mp4",
    "height": 1920,
    "width": 1080,
    "length_in_second": 23.36,
    "thumbnail": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.82787-10/549761436_18521992156021539_7633323777597918486_n.jpg?stp=dst-jpg_tt6&cstp=mx1194x2116&ctp=s960x960&ccb=1-7",
    "captions_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.2093-6/548496336_1535656704092956_4849526113470105591_n.srt?ccb=1-7"
  },
  "author": {
    "id": "100000076236457",
    "name": "Matt West",
    "handle": "matt.west.184",
    "is_verified": true,
    "url": "https://www.facebook.com/matt.west.184",
    "image": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/907915316_29807785398807275_5489917152185553848_n.avif?stp=cp0_dst-jpg_tt6&cstp=mx960x958&ctp=s40x40&ccb=1-7"
  },
  "music": {
    "id": "1506592770696336",
    "type": "CUSTOM_AUDIO",
    "track_title": "Matt West · Original audio",
    "music_album_art": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/907915316_29807785398807275_5489917152185553848_n.avif?stp=cp0_dst-jpg_tt6&cstp=mx960x958&ctp=s64x64&ccb=1-7"
  }
}
Response JSON · /v1/facebook/post

What it returns

success boolean
credits_remaining integer
credits_charged integer
post_id string
shared_post_id null
shared_post_url null
is_paid_partnership nullboolean
True when Facebook marks the post as branded content or sponsored
like_count integer
comment_count integer
share_count integer

Parameters

url string query required

The URL of the reel or video

allow_long_transcription boolean query optional

Accepted for compatibility and ignored. Transcripts are Facebook's own captions, never AI, at no extra cost.

get_transcript boolean query optional

Set get_transcript=true for the reel's own captions (SRT) at no extra cost. Missing captions return transcript: null.

cache_max_age string query optional

Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.

Options: 1d3d7d14d30d

Use cases

Billing

Errors cost zero credits, and so do cache hits through cache_max_age. Empty results follow this operation’s rules.

Default: 1 credit

An empty result costs 0 credits.

How charges are determined

Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.

A call that fails costs 0 credits. A result served from cache costs 0 credits.

`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.

A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).

A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.

FAQ

How much does the Facebook Post API cost?

A call costs 1 credit by default. Errors cost 0 credits, and a cached result served through cache_max_age costs 0. New accounts get 100 free credits with no card. After that, credits come in one-time packs that never expire: 25,000 for $27 and 500,000 for $297 (plus any tax). There is no subscription.

What do I need to call it?

An API key in the x-api-key header, plus url. You don't need a Facebook account or developer app.

What does it return?

Typed JSON. Top-level fields include post_id, shared_post_id, shared_post_url, is_paid_partnership, like_count and comment_count. The full schema and a real sample response are on this page and in the API reference.

Is this an official Facebook API?

No. Fetchproof is an unofficial API that returns public Facebook data only.