Facebook hub

Facebook Video Search API

Keyword search over public Facebook videos and Reels, in Facebook's own ranking, as structured rows.

GET /v1/facebook/videos/search

1 credit Failed requests are free

About this endpoint

GET /v1/facebook/videos/search takes a required query and returns matching videos and Reels under data.videos: id, url, title, description, createdAt, durationMs, thumbnailUrl, isPaidPartnership and the author. When data.page.hasMore is true, pass data.page.nextCursor as cursor with the same query for the next page.

Results follow Facebook's ranking and public availability, so they are not exhaustive. Some rows have no exact time; dateText then carries Facebook's own label, such as Sep 5 ยท 89K views. A transcript of one video is GET /v1/facebook/posts/transcript.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Facebook Video Search API FAQ

What does the Facebook Video Search API return?

A page of public videos and Reels matching your keyword, each with its URL, caption, author, publish time, duration and thumbnail, plus data.page for the next page.

How do I get the next page?

Pass data.page.nextCursor as cursor and keep query the same. Stop when data.page.hasMore is false.

Why is isPaidPartnership null and never false?

It is true when Facebook labels the video as a paid partnership. A missing label does not prove a video is unsponsored, so the field is null rather than false.

How much does the Facebook Video Search API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.