List Facebook profile reels
Lists public Facebook reels for a profile or page URL. Check `data.lookupStatus` for `found` vs `not_found`. Use `data.page.nextCursor` to request the next page when `data.page.hasMore` is true.
Operation
/v1/facebook/profiles/reelsHeaders
API key (`sfk_...`)
Parameters
Public Facebook profile or page URL whose reels should be listed.
min 1 chars · max 4096 chars
Opaque pagination cursor from a previous response (`data.page.nextCursor`).
min 1 chars · max 4096 chars
Response fields
Endpoint-specific response payload.
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.
Stable reel identifier from Facebook.
min 1 chars
Underlying Facebook post id when available.
Underlying Facebook video id when available.
Public Facebook URL for this reel.
min 1 chars
Caption or description text when available.
ISO-8601 timestamp for when the reel was created.
View count when available.
≥ 0
Thumbnail image URL when available.
Direct video URL when available.
Play duration in milliseconds when available.
≥ 0
Music metadata when available.
Music track title when available.
Author metadata when available.
Facebook id for the reel author when available.
Display name for the reel author when available.
Whether Facebook marks the author as verified.
Public Facebook URL for the author when available.
Profile image URL for the author when available.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of reels can be requested.
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
Code example
Responses
Facebook reels for the requested profile or page. Check `data.lookupStatus` for `found` vs `not_found`.
Error codes
Profile posts
Lists public posts for a Facebook profile or page identified by `url` or `pageId`, with cursor-based pagination. Private profiles, missing pages, and profiles with no public posts can all surface as HTTP `200` with an empty `data.posts` page—this route does not expose `lookupStatus`. Call `GET /v1/facebook/profiles` first when you need explicit `found` / `private` / `not_found` before interpreting an empty list.
Profile photos
Lists public Facebook photos for a profile or page URL. Check `data.lookupStatus` for `found` vs `not_found`. Use `data.page.nextCursor` to request the next page when `data.page.hasMore` is true.