> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/facebook/videos-search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/facebook/videos-search.mdx>

---

# 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` 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`.

## Request

- **Endpoint:** `GET /v1/facebook/videos/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by keyword
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/facebook/videos/search/get)
- **Platform page:** [/platforms/facebook](https://www.socialfetch.dev/platforms/facebook)

## 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.
