Post Transcript

GET/v1/facebook/post/transcript1 credit

Returns the transcript of a Facebook post's video or reel with the video's duration, taken from its captions when it has them and made with AI otherwise.

01Query parameters

Name	Type	Description
urlrequired	string	A Facebook post, video or reel URL, e.g. `https://www.facebook.com/reel/1634870324219177`.
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

1 credit when the video has captions (any length) or is up to 120 seconds long. A longer video without captions is refused with a free 400 unless `allow_long_transcription=true`, which costs 10 credits per started minute. A post without a video or without speech returns `transcript: null` for 0 credits.

03Request

curl "https://api.scrapesocial.ai/v1/facebook/post/transcript?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/transcript?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1634870324219177

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "post_id": "1593991512733150",
  "transcript": "I need to focus on what I'm uniquely good at. Now, this is where everybody's problem is. Nobody's told them what to be uniquely good at, and so they're waiting for somebody to tell them, do this. You got to figure out what works for you. I'm just telling you, if you are like, I need momentum, then you have no other time to do anything else.",
  "duration_seconds": 31.033,
  "duration_minutes": 0.52
}

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

The response holds `post_id`, `transcript`, `duration_seconds` and `duration_minutes`. A URL that is not a Facebook post is a free 400; an unknown post is a free 404.

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.