Social Fetch
Facebook

List Facebook profile reels

Get Reels from a Facebook profile or page.

GET/v1/facebook/profiles/reels
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
url*stringquery

Public Facebook profile or page URL whose reels should be listed.

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque pagination cursor from a previous response (`data.page.nextCursor`).

min 1 chars · max 4096 chars

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

Whether the requested profile or page resolved for this request.

one of: found, not_found

Reels returned for the requested profile or page. This array may be empty on the last page.

datareels[]id
string

Stable reel identifier from Facebook.

min 1 chars

datareels[]postId
stringnullable

Underlying Facebook post id when available.

datareels[]videoId
stringnullable

Underlying Facebook video id when available.

datareels[]url
string

Public Facebook URL for this reel.

min 1 chars

datareels[]description
stringnullable

Caption or description text when available.

datareels[]createdAt
stringnullable

ISO-8601 timestamp for when the reel was created.

datareels[]viewCount
integernullable

View count when available.

≥ 0

datareels[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

datareels[]videoUrl
stringnullable

Direct video URL when available.

datareels[]durationMs
integernullable

Play duration in milliseconds when available.

≥ 0

Music metadata when available.

datareels[]musictitle
stringnullable

Music track title when available.

Author metadata when available.

datareels[]authorplatformUserId
stringnullable

Facebook id for the reel author when available.

datareels[]authorname
stringnullable

Display name for the reel author when available.

datareels[]authorisVerified
booleannullable

Whether Facebook marks the author as verified.

datareels[]authorurl
stringnullable

Public Facebook URL for the author when available.

datareels[]authorimageUrl
stringnullable

Profile image URL for the author when available.

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.

datapagehasMore
boolean

Whether another page of reels can be requested.

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

Code example

curl "https://api.socialfetch.dev/v1/facebook/profiles/reels?url=https://www.facebook.com/profile.php?id=61575098504636" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Facebook reels for the requested profile or page. Check `data.lookupStatus` for `found` vs `not_found`.

On this page

No Headings