Facebook Reels Scraper

Give it a Facebook page, get its reels back — each with the reactions, comments and shares that most reel scrapers leave blank, plus caption, creation date, duration, thumbnail, direct video URL, and the page's own name and follower count. One row per reel.

Input	Rows emitted
https://www.facebook.com/9GAGCute	one row per recent reel, with engagement counts
https://www.facebook.com/LeonardoDiCaprio	same, for that page
a page with no reels	one error row naming it, not charged

Pure HTTP over a residential proxy. No browser, no login, no cookies, no third-party unlocker.

---

Why Use This Scraper?

Two things break most Facebook reel scrapers: Facebook hands a login wall to data-centre IPs, so they return nothing, and even when they do return reels they skip the engagement counts. This runs over a residential proxy by default, so it gets the real page — and it recovers the reaction, comment and share numbers from the page's own data. If a run genuinely finds nothing, it fails loudly rather than reporting an empty success.

---

How It Works

Each page URL is normalised to its reels tab and fetched over a residential proxy. The reels tab is server-rendered, so the HTML already carries the page's most recent reels as structured data. The Actor parses each reel and joins back the reaction, comment and share counts Facebook normalises into a separate part of the response, then emits one flat row per reel. A page that returns no reels becomes a named error row rather than a silently shorter list.

---

Input

Field	Type	Required	Default	Notes
startUrls	array	Yes	—	Facebook page/profile URLs. Main URL, handle, or reels-tab URL all work.
resultsLimit	integer	No	20	Max reels per page, newest first. The reels tab exposes ~10-12 per page in one pass.
onlyPostsNewerThan	string	No	—	Keep only reels created on/after this date (ISO). Older reels dropped, not charged.

Example input

{
  "startUrls": [{ "url": "https://www.facebook.com/9GAGCute" }],
  "resultsLimit": 20
}

---

Output Schema

One row per reel, page context denormalised onto each row so a spreadsheet needs no second lookup:

{
  "reelUrl": "https://www.facebook.com/reel/1310318585490776",
  "reelId": "1310318585490776",
  "caption": "meow code crashing",
  "createdAt": "2026-08-25T12:55:49.000Z",   // ISO 8601
  "createdTimestamp": 1787662549,             // epoch seconds, as Facebook gives it
  "reactionsCount": 838,
  "commentsCount": 15,
  "sharesCount": 80,                          // exact when Facebook exposes a plain integer
  "sharesText": "80",                         // Facebook's own label, e.g. "2.6K", when that is all it gives
  "durationMs": 12138,
  "durationSeconds": 12.1,
  "thumbnailUrl": "https://scontent.xx.fbcdn.net/v/t15.5256-10/...",
  "videoUrl": "https://video.xx.fbcdn.net/o1/v/t2/f2/...mp4",   // direct, time-limited
  "ownerId": "100077223652881",
  "pageUrl": "https://www.facebook.com/9GAGCute",
  "pageName": "9GAG Cute",
  "pageId": "100077223652881",
  "pageFollowerCountText": "3.7M",            // Facebook's own rendered label
  "scrapedAt": "2026-08-29T13:56:46.713Z"
}

Error rows

error	Meaning	Charged
invalid_url	Not a facebook.com URL.	No
page_not_found	Facebook returned 404/410 — private, removed, or wrong URL.	No
no_reels_found	The page returned no public reels.	No
no_reels_in_range	All the page's reels are older than onlyPostsNewerThan.	No

---

What Makes This Richer Than the Competition

Built from the open complaints on other Facebook reel scrapers — missing likes/comments, "no results without login", and "returns success with no stats":

Capability	Typical reel scraper	This Actor
Reel URL, caption, creation date	yes	yes
Reactions count	often blank	yes
Comments count	often blank	yes
Shares	no	yes
Direct video URL	sometimes	yes
Duration + thumbnail	sometimes	yes
Page name + follower count	no	yes, on every row
Works from a data-centre run	no, login wall → empty	yes, residential by default
Empty run fails loudly	no, reports success	yes, never a silent-empty
Bad page named, not charged	no	yes

---

Pricing

Pay per event — you are charged per reel returned, never for the pages that come back as error rows.

Event	When it fires	Rate
Actor start	Once per run	$0.001
Reel	Each reel row delivered	from $0.003

Error rows (invalid, not found, no reels, out of range) are never charged.

---

Notes & Limitations

The reels tab exposes roughly the latest 10-12 reels per page in one pass, so resultsLimit returns what is available rather than an unlimited back-catalogue. This is a deliberate v1 boundary in favour of reliability; deeper history would need cursor pagination.

videoUrl is a direct, time-limited Facebook CDN link — fetch or store the file promptly, as the URL expires. pageFollowerCountText and sharesText are Facebook's own rounded labels (e.g. "3.7M", "2.6K"); reactionsCount and commentsCount are exact integers.

---

FAQ

Do I need a Facebook account, login, or cookies? No. Nothing is authenticated. The Actor reads the same public reels a logged-out visitor sees.

Why do other reel scrapers return nothing for me? Facebook serves a login wall to data-centre IPs. This Actor uses a residential proxy by default, so it gets the real page.

Can I get more than ~12 reels per page? Not in this version. It returns the page's most recent reels in one reliable pass. Deeper pagination is a planned enhancement.

Do I get likes and comments? Yes — reactionsCount and commentsCount on every reel, exact. That is the main gap this Actor closes versus other reel scrapers.

What if a run returns nothing? It exits FAILED with a reason rather than reporting success with an empty dataset — unless every requested page was genuinely reel-less, which exits SUCCEEDED with a row per page explaining why.

---

🤖 For AI Agents & LLM Apps

Purpose: scrape a Facebook page's reels with engagement. Give it page URLs, get one flat row per reel including reactions, comments and shares.

Minimal tested input:

{ "startUrls": [{ "url": "https://www.facebook.com/9GAGCute" }], "resultsLimit": 20 }

Output fields (flat, one row per reel): reelUrl, reelId, caption, createdAt, createdTimestamp, reactionsCount, commentsCount, sharesCount, sharesText, durationMs, durationSeconds, thumbnailUrl, videoUrl, ownerId, pageUrl, pageName, pageId, pageFollowerCountText, scrapedAt.

Error rows carry pageUrl + error + message and no reel fields. Branch on the presence of error. Values: invalid_url, page_not_found, no_reels_found, no_reels_in_range.

Billing: one reel event per reel row, plus one actor start. Error rows are not charged.

Behaviour worth knowing: returns roughly the latest 10-12 reels per page in one pass; reactionsCount/commentsCount are exact integers while sharesText/pageFollowerCountText are Facebook's rounded labels; videoUrl is a direct time-limited CDN link; an empty run fails loudly unless every page was genuinely reel-less.

---

⚠️ Disclaimer

This Actor collects only publicly available information from Facebook — the same reels any logged-out visitor can see. It does not log in, use cookies, or access private content. You are responsible for using the output in line with Facebook's terms and applicable data protection law, including GDPR where personal data is involved.

---

SEO Keywords

facebook reels scraper, facebook reels api, scrape facebook reels, facebook video scraper, facebook reels views, facebook reels likes comments, facebook page reels, facebook reels downloader, facebook reels engagement, facebook short video scraper, facebook reels data export, facebook reels metadata