fb.watch short links are all supported.
Request
Response
transcript is a plain string with newlines between spoken lines — there is no per-line timing in the Facebook response and no title field. videoUrls is included when the upstream exposes a video (Facebook usually provides both sd and hd); it is omitted when none is available. The sd and hd download links are only filled in on the Plus and Pro plans (video download is a Plus and Pro feature). On other plans they are null and only thumbnail is set.
Supported URL formats
The bare
facebook.com/watch Watch home page (no ?v=) is rejected with 400 Invalid URL — the validator requires a v query parameter.
FAQ
Do private or friends-only Facebook videos work?
Do private or friends-only Facebook videos work?
No. Only publicly viewable videos can be transcribed.
What about videos in private Groups?
What about videos in private Groups?
Group-only videos aren’t supported because the API can’t authenticate as a group member.
Does it work on Facebook Live in progress?
Does it work on Facebook Live in progress?
No — only completed Live replays. Live-in-progress streams don’t have stable transcripts to fetch.
What if the video has no captions?
What if the video has no captions?
You’ll get a
404 with error: "No transcript available for this video" and a code (no_speech when the video has no spoken captions, video_unavailable when it can’t be found), and you won’t be charged.