> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/facebook/profiles-reels>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/facebook/profiles-reels.mdx>

---

# 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` 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`.

## Request

- **Endpoint:** `GET /v1/facebook/profiles/reels`
- **Credits:** 1 credit
+2 credits per hosted file (hostMedia), max 24 files
Max 49 credits
Failed requests are free
- **Input:** by profile or page URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/reels/get)
- **Platform page:** [/platforms/facebook](https://www.socialfetch.dev/platforms/facebook)

## 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.