All-in-One Facebook Scraper

The Actor collects seven Facebook datasets — a Page's profile, its timeline posts, its followers or following list, its videos, its photo albums, Marketplace browse listings, and individual Marketplace listing lookups — through a single run configuration. The dataset is chosen with scraperType; each mode reads its own input and returns that dataset's fields.

Callers who only ever need one of these are better served by the focused Actor for it, listed at the end. This Actor exists for workflows that need several, or that would rather integrate once.

Everything it returns comes from what Facebook serves to a logged-out, anonymous visitor. No Facebook account, login, or session cookie is used at any point.

Modes

Mode	scraperType value	Key input	Returns
Page profile	pageProfile	page	One record per Page: its numeric ID, permalink, and — where requested — its About section and Page Transparency details
Page posts	pagePosts	page	One record per timeline post: its text, creation time, and permalink
Followers/following	pageCollection	page, collection	The accounts following the Page, or the accounts it follows, with the Page's reported total on every row
Videos	pageVideos	page	One record per video: its ID and a composed watch link — Facebook's logged-out video list exposes nothing further
Photo albums	pageAlbums	page	One record per album: title, cover image, and link
Marketplace browse	marketplaceListings	category (optional)	The listings on Marketplace's home feed, or a category feed, as Facebook serves them for the request
Marketplace listing	marketplaceItem	itemId	One record per listing ID or URL supplied, with its full detail record

scraperType is the only required input. Each mode raises a clear error when the identifier it needs is absent, so an otherwise empty run fails immediately rather than returning an unexpected dataset.

{
  "scraperType": "pageProfile",
  "page": ["NASA", "https://www.facebook.com/unicef/"],
  "includeAbout": true,
  "includeTransparency": false
}

Enrichment

Two optional add-ons attach related records to rows that would otherwise carry only a thin one. Each is opt-in, off by default, and costs one extra request per enriched row.

Add-on	Mode	Attaches	Cost
addonAccountProfile	Followers/following	The listed account's own Page record and About details, under accountProfile	$0.006 per enriched row
addonListingDetails	Marketplace browse	The browsed listing's full detail record, under listingDetails	$0.0008 per enriched row

Both are charged only for a row that is actually enriched; a lookup that fails leaves the row without the attached field and is not billed. Marketplace listing lookups (marketplaceItem) always return a full detail record and need no add-on to get one.

Limits

maxItems bounds the number of records saved by the paginating modes — posts, followers/following, videos, albums, and Marketplace browse and listing lookups. Page profile lookups return one row per Page and ignore it. maxItems applies per Page where the mode reads several Pages, so with several Pages supplied a low value is spent on the first Page in the list before any later one is reached. Setting it to 0 continues until Facebook stops returning a next page, where a next page exists.

Marketplace browse has no logged-out pagination beyond its first batch of roughly 20 listings, so maxItems above that count does not produce more rows in that mode — it can only trim the batch down.

Behaviour worth knowing

Videos are sparse by design, not by omission. Facebook's logged-out video list returns only a video's ID and owner; titles, dates, durations, and thumbnails are not present in that response at any depth, so pageVideos does not claim them.

Marketplace browse is regional and unpaginated. Results reflect where the request is understood to be browsing from, so the same category can return a different set of listings between runs, and there is no next page beyond the first roughly-20-listing batch.

About and Transparency are flat maps, not fixed columns. about and transparency on the Page profile mode are keyed by Facebook's own field names — category, contact details, website links, and similar — and are null when their toggle is off or Facebook's own document did not carry that section for the Page.

Post comments are not offered. Facebook exposes no logged-out paginator for post comments, so no mode returns a comment thread.

A Page that cannot be resolved is skipped, not fatal. Whether the username or ID does not exist, or the Page is not public, that Page is logged as a warning and the run continues with the rest of the input list.

Focused alternatives

Actor	Use instead when
Facebook Page Scraper	Only Page profile, About, or Transparency details are needed
Facebook Posts Scraper	Only timeline posts are needed
Facebook Followers/Following Scraper	Only followers or following lists are needed
Facebook Videos Scraper	Only a Page's videos are needed
Facebook Photo Albums Scraper	Only a Page's photo albums are needed
Facebook Marketplace Scraper	Only Marketplace browsing is needed
Facebook Marketplace Item Scraper	Only specific Marketplace listings are needed