Social Fetch
Get API key
Facebook hub

Facebook profile Reels API

List recent public Reels from a Facebook profile or Page — captions, view counts, thumbnails, and video URLs when available — with cursor pagination in the shared Social Fetch envelope.

GET /v1/facebook/profiles/reels

1 credit base. With `hostMedia`, +2 credits per hosted asset (up to 24 assets, 49 credits max).

Try in playgroundFull API docs

About this endpoint

`GET /v1/facebook/profiles/reels` lists public Reels for a profile or Page. Pass a full public `url` query param. On a completed lookup, branch on `data.lookupStatus` (`found` or `not_found`), then read `data.reels` and `data.page`. Each reel can include id, postId, videoId, public url, description, createdAt (ISO-8601), viewCount, thumbnailUrl, videoUrl, durationMs, optional music.title, and author fields when Facebook exposes them. When `data.page.hasMore` is true, pass `data.page.nextCursor` as the `cursor` query param on the next call. Bill from `meta.creditsCharged`.

`thumbnailUrl` and `videoUrl` are source-platform CDN links when Facebook exposes them. They can expire or fail outside the original retrieval context and are not SocialFetch-hosted assets. For SocialFetch-hosted copies on this list page, pass `hostMedia=true` (up to 24 assets / 90-day retention; +2 credits per successfully stored asset). Author avatar URLs are never hosted.

This route lists Reels only. The mixed Page or profile feed is `GET /v1/facebook/profiles/posts`. A single post or reel by URL is `GET /v1/facebook/posts`. Photos are `GET /v1/facebook/profiles/photos`.

Facebook profile Reels API FAQ

How do I list Facebook Reels for a profile or Page via API?

Call `GET /v1/facebook/profiles/reels` with your Social Fetch API key (`x-api-key`) and a public Facebook profile or Page `url` query param. Read `data.lookupStatus`, then `data.reels` and `data.page`. See the API docs for parameters and examples.

How much does the Facebook profile Reels endpoint cost?

1 credit per successful list page by default. With `hostMedia`, +2 credits per hosted asset (up to 24 assets, 49 credits max). Always bill from `meta.creditsCharged` on the response. Each paginated page is a separate billed request.

How does pagination work on Facebook profile Reels?

Each response includes `data.page.nextCursor` and `data.page.hasMore`. When `hasMore` is true, pass `nextCursor` as the `cursor` query param on the next request. The cursor is opaque.

What fields are in each Facebook profile Reel?

Items can include id, postId, videoId, public url, description, createdAt (ISO-8601), viewCount, thumbnailUrl, videoUrl, durationMs, optional music.title, and author metadata (platformUserId, name, isVerified, url, imageUrl) when Facebook exposes them. Coverage follows what is publicly visible for that profile or Page.

What does lookupStatus mean on Facebook profile Reels?

Branch on `data.lookupStatus` before you write rows. `found` means the profile or Page resolved and `data.reels` is the current page (it may still be empty on a last page). `not_found` means the URL did not resolve to a listable profile or Page — do not invent a Reels grid. Keep `meta.requestId` if you need support on a failed list call.

Profile Reels vs profile posts vs a single Facebook post?

Use this route to page a profile or Page Reels tab. Use `GET /v1/facebook/profiles/posts` for the mixed feed. Use `GET /v1/facebook/posts` when you already have a post or reel URL. Photos are a separate list on `GET /v1/facebook/profiles/photos`.

Do I need Meta Graph API access or page admin rights?

No. Social Fetch returns publicly visible Reels for enrichment-style lookups. Meta's Graph and Marketing APIs are for assets and ads accounts you control or that authorize your app — not arbitrary public competitor Pages.

Other Facebook endpoints