Search Facebook videos
Search Facebook videos and Reels by keyword.
Headers
Get your API keyAPI key (`sfk_...`)
Keyword or phrase to search Facebook videos and Reels for, such as `dogs`.
min 1 chars · max 512 chars
Pass `page.nextCursor` from the previous response to get the next page. Keep `query` unchanged.
min 1 chars
Endpoint-specific response payload.
Search query evaluated for this response.
Videos and Reels on this page, in Facebook's ranking order.
Facebook video id.
min 1 chars
Public Facebook URL of the video or Reel.
min 1 chars
Video title when it has one.
Caption or description text.
ISO-8601 timestamp of when the video was published, when Facebook gives it.
Facebook's own date label, sometimes with views (`Sep 5 · 89K views`), shown when the exact time is missing.
Play duration in milliseconds when available.
≥ 0
Source-platform CDN URL for the thumbnail. It can expire; it is not a SocialFetch-hosted asset.
True when Facebook labels the video as a paid partnership. Null when Facebook does not say; never false, since a missing label does not prove there is no sponsorship.
Author of the video when available.
Facebook id of the profile or Page that posted the video.
Display name of the author.
Public Facebook URL of the author.
Number of videos returned in this response.
≥ 0
Pagination information for the current response.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/facebook/videos/search?query=dogs" \
-H "x-api-key: YOUR_API_KEY"Responses
Facebook videos matching the search.