Social Fetch
Start for freeStart free
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 +2 credits per hosted file (hostMedia), max 24 files Max 49 credits Failed requests are free

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