Search Facebook videos

Search Facebook videos and Reels by keyword.

GET/v1/facebook/videos/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

Keyword or phrase to search Facebook videos and Reels for, such as `dogs`.

min 1 chars · max 512 chars

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Keep `query` unchanged.

min 1 chars

Response fields
26

Endpoint-specific response payload.

dataquery
string

Search query evaluated for this response.

Videos and Reels on this page, in Facebook's ranking order.

datavideos[]id
string

Facebook video id.

min 1 chars

datavideos[]url
string

Public Facebook URL of the video or Reel.

min 1 chars

datavideos[]title
stringnullable

Video title when it has one.

datavideos[]description
stringnullable

Caption or description text.

datavideos[]createdAt
stringnullable

ISO-8601 timestamp of when the video was published, when Facebook gives it.

datavideos[]dateText
stringnullable

Facebook's own date label, sometimes with views (`Sep 5 · 89K views`), shown when the exact time is missing.

datavideos[]durationMs
integernullable

Play duration in milliseconds when available.

≥ 0

datavideos[]thumbnailUrl
stringnullable

Source-platform CDN URL for the thumbnail. It can expire; it is not a SocialFetch-hosted asset.

datavideos[]isPaidPartnership
booleannullable

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.

datavideos[]authorplatformUserId
stringnullable

Facebook id of the profile or Page that posted the video.

datavideos[]authorname
stringnullable

Display name of the author.

datavideos[]authorurl
stringnullable

Public Facebook URL of the author.

datatotalVideos
integer

Number of videos returned in this response.

≥ 0

Pagination information for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.