Post

GET/v1/facebook/post1 credit

Returns a Facebook post, video or reel: text, author, reaction, comment, share and view counts, media links and the first 10 comments, optionally with a transcript of its video.

01Query parameters

Name	Type	Description
urlrequired	string	A Facebook post, video or reel URL, e.g. `https://www.facebook.com/reel/1634870324219177`.
get_transcriptoptional	boolean	Set to `true` to add a `transcript` of the post's video.Default: `false`
allow_long_transcriptionoptional	boolean	Set to `true` to transcribe a video longer than 120 seconds with AI, at 10 credits per started minute. Only the literal value `true` opts in.Default: `false`
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh and billed normally. A value outside the list is rejected with a free 400.Accepted values:`1d3d7d14d30d`

02Pricing

The post costs 1 credit. With `get_transcript=true` the price stays 1 credit for a video with captions or one up to 120 seconds long; a longer video without captions is refused with a free 400 unless `allow_long_transcription=true`, which bills 10 credits per started minute instead. A post without a video gets `transcript: null` at the base price.

03Request

curl "https://api.scrapesocial.ai/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1634870324219177" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1634870324219177

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "post_id": "1593991512733150",
  "like_count": 312,
  "reaction_counts": {
    "thankful": 0,
    "like": 273,
    "love": 32,
    "care": 1,
    "haha": 2,
    "wow": 4,
    "sad": 0,
    "anger": 0,
    "pride": 0,
    "confused": 0
  },
  "comment_count": 88,
  "share_count": 18,
  "view_count": 28290,
  "description": "After meeting 40,000+ people across 100 cities…\n\nI noticed something.\n\nMost people don’t have a lead problem.\n\nThey have a conversation problem.\n\nEveryone is watching:\n\nYouTube\nChatGPT\nPodcasts\nCourses\n\nBut almost nobody is talking to:\n\n• Sellers\n• Brokers\n• Owners\n• Property managers\n\nWhy?\n\nBecause the moment you talk to a real seller…\n\nYou might realize you don’t know everything.\n\nAnd most peopl…",
  "creation_time": "2026-03-08T15:55:57.000Z",
  "feedback_id": "ZmVlZGJhY2s6MTU5Mzk5MTUxMjczMzE1MA==",
  "url": "https://www.facebook.com/reel/1634870324219177",
  "image_url": null,
  "video": {
    "id": "1634870324219177",
    "sd_url": "https://video.fyei6-4.fna.fbcdn.net/o1/v/t2/f2/m412/AQNfvrmvWK1_8m9wYQbGE8x83nheuNcyg8PRylHKiagvQJAR30dCWbigqQtCU1lRak5MZPQ_drA_fHPKk0E3PYhdOeXEachqDUNSDSXN-g.mp4?_nc_cat=110&_nc_oc=Adq0Unla8YEh5GGaH9ZqIsSmDkGnywZ7hCcH10JZSm1Q_wKN24glITfvFZCChMhoc-Q&_nc_sid=8bf8fe&_nc_ht=video.fyei6-4.fna.fbcdn.net&_nc_ohc=KeXCF0VjaTsQ7kNvwFoV_qC&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYw…",
    "hd_url": "https://video.fyei6-3.fna.fbcdn.net/o1/v/t2/f2/m366/AQNjVfABeMdY6_CB2IV5L-pdvriV6PTsFjJBr1VWsPGw8TCSafFWuQKgDP1m2mjqHQQnoBWwvvAfoUtubsUpKNAr4lKZv4eTy_lnrTQ71ZJjsg.mp4?_nc_cat=107&_nc_oc=Adqm23uz7XPQjA1iXaaIQI5_8OcqWuJ6iV-XX8W1hYErjiKWeys6Y0y4DK4qwhF3GBY&_nc_sid=5e9851&_nc_ht=video.fyei6-3.fna.fbcdn.net&_nc_ohc=t02RHLq-oj0Q7kNvwFe0Nrt&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMu…",
    "height": 1280,
    "width": 720,
    "length_in_second": 31.033,
    "thumbnail": "https://scontent.fyei6-5.fna.fbcdn.net/v/t15.5256-10/649485223_1634870974219112_2297344106941848618_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=be8305&_nc_ohc=LyvuxV5iLuUQ7kNvwHNAJJv&_nc_oc=AdozlfyMfjR0wpQnGcC3CQ4GIs-3zGn5Lhroj7hJwKPr74Br6NUgOAbJpXTlGrkevMA&_nc_zt=23&_nc_ht=scontent.fyei6-5.fna&_nc_gid=cvlSaUrV0IDithANFubf7A&_nc_ss=7b289…",
    "captions_url": null
  },
  "author": {
    "id": "100063669491743",
    "name": "Pace Morby",
    "handle": "pacemorby",
    "is_verified": false,
    "url": "https://www.facebook.com/pacemorby",
    "image": "https://scontent.fyei6-1.fna.fbcdn.net/v/t39.30808-1/255454150_435897101280118_3837292553331400103_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1365x1364&ctp=s80x80&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=H08x99FEJu4Q7kNvwH6ZwlK&_nc_oc=Adr3-IwtBBPZKkZzWPH8AJFzBOSvzjzwfPLZpEV9PSQWvnFXa5SmEuU9fVj1S6a-JTU&_nc_zt=24&_nc_ht=scontent.fyei6-1.fna&_nc_gid=i8DckrsAb4GZVB6aIBBMTw&_nc_ss=7b2…"
  },
  "music": {
    "track_title": null,
    "music_album_art": "https://scontent.fyei6-1.fna.fbcdn.net/v/t39.30808-1/255454150_435897101280118_3837292553331400103_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1365x1364&ctp=s64x64&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=0fc832&_nc_ohc=H08x99FEJu4Q7kNvwH6ZwlK&_nc_oc=Adr3-IwtBBPZKkZzWPH8AJFzBOSvzjzwfPLZpEV9PSQWvnFXa5SmEuU9fVj1S6a-JTU&_nc_zt=24&_nc_ht=scontent.fyei6-1.fna&_nc_gid=i8DckrsAb4GZVB6aIBBMTw&_nc_ss=7b2…"
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

05Notes

A URL that is not a Facebook post is a free 400; an unknown post is a free 404. A reel has `music` and no `comments` or `images`. `share_count` is null for `/watch/` and `/videos/` URLs, and `link_attachment` is filled only for shared links.

06Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.