Facebook Pages Scraper

Extract reliable, quality-checked data from public Facebook Pages. Personal profiles are accepted as best-effort inputs, but only public Pages are covered by the usable-item reliability target.

The Actor bills a result only when it contains a real Page name, a canonical Facebook URL, and at least one high-value signal: Facebook ID, detected follower/like count (including zero), bio/about text, category, website, email, phone, or address. Image-only identities are rescued when possible and otherwise reported without charge.

Quick start

Enter Page usernames or URLs, one per line:

nasaearth
Microsoft
https://www.facebook.com/UNICEF

Click Start, then download usable results as JSON, CSV, or Excel from Storage.

What you get

• Page name, canonical URL, username, Facebook ID, verification, and category
• Followers and likes, with separate detection flags so zero is not confused with missing data
• About text, website, email, phone, and address when publicly available
• Profile and cover images as supplemental fields
• Quality tier and the exact signals that made the result billable
• Controlled diagnostics for every invalid, blocked, unavailable, identity-only, or timed-out input

Contact fields are best-effort because many Pages do not publish them.

Input options

Parameter	Default	Description
profiles	example Pages	Page usernames or URLs, one per line
mode	fast	Fast, balanced, or deep extraction budget
proxyType	BUYPROXIES94952	Primary datacenter, residential, or static-US proxy
maxConcurrency	2	Concurrent HTTP Page state machines; browser concurrency is always one
maxRequestsPerMinute	15	One global limit shared by HTTP and browser navigation
maxProfiles	10	Maximum unique inputs processed in one run
maxRuntimePerProfileSecs	25	Maximum browser-rescue budget per input
enableResidentialFallback	true	Selective residential rescue for blocks/transient failures
requireAuthenticatedData	false	Use one sticky authenticated browser/proxy identity
cookies	empty	Optional Facebook cookies as a JSON array

Blank, malformed, duplicate, and unsupported Facebook URLs are handled inside the Actor. They do not cause a platform-level failed run.

Output example

The exact fields vary with what a Page publishes. A current result has this shape:

{
  "inputUrl": "https://www.facebook.com/nasaearth",
  "scrapedUrl": "https://www.facebook.com/nasaearth",
  "profileType": "page",
  "supportedScope": "public_page",
  "name": "NASA Earth",
  "username": "nasaearth",
  "followers": 10900000,
  "followersDetected": true,
  "likesDetected": false,
  "about": "Exploring our home planet.",
  "qualitySignals": ["followers", "about"],
  "dataQualityTier": "core",
  "resultStatus": "success",
  "isUsable": true,
  "attemptCount": 1,
  "fallbackStages": ["primary_http"],
  "extractionStage": "primary_http"
}

Existing successful-result fields are preserved. The quality fields are additive:

• dataQualityTier: core or enriched
• qualitySignals: fields satisfying the high-value contract
• followersDetected / likesDetected: distinguishes a legitimate zero from missing data
• supportedScope: public_page for supported Pages or best_effort_profile for personal profiles

Reliability and diagnostics

Actor run success means the run finished cleanly and assigned every input a controlled terminal outcome. Item success means genuinely usable Page data was produced.

Only core and enriched results enter the billable default dataset. Everything else is stored in the FAILURES key-value record. The output page links to:

• SUMMARY: requested/processed counts, public-Page and best-effort-profile counts, Page and overall item success, quality tiers, count-detection rate, stage/rescue counts, reasons, duration, deadline stops, and resource settings
• FAILURES: per-input terminal outcomes that were not billed
• SUPPORT_BUNDLE: sanitized build/run IDs, aggregate stages, resource settings, and failure codes

SUPPORT_BUNDLE never contains Page inputs, cookies, contact data, or proxy credentials.

The Actor has a 540-second soft deadline under the 600-second platform timeout. It stops starting a stage when the measured remaining-time requirement no longer fits, persists a terminal outcome for every input, writes diagnostics, and exits cleanly.

Extraction pipeline

Each input moves through a bounded state machine:

1. Primary HTTP extraction
2. One residential HTTP rescue for blocks or transient errors, when enabled
3. One single-concurrency browser rescue only while core Page data is missing

Only timeouts, connection failures, and HTTP 5xx responses are retried. Invalid, private, and unavailable inputs terminate immediately. One shared limiter governs every HTTP request and browser navigation.

enableResidentialFallback=false keeps browser rescue on the primary proxy. It does not silently switch browser traffic to residential.

Authentication

Authenticated mode requires valid c_user and xs cookies. Missing or malformed cookies return INVALID_OR_EXPIRED_COOKIES without network work.

[
  {"name": "c_user", "value": "YOUR_USER_ID", "domain": ".facebook.com"},
  {"name": "xs", "value": "YOUR_SESSION", "domain": ".facebook.com"}
]

The entire authenticated run uses concurrency one, one crawler session, and one sticky proxy identity. If Facebook sends that session to a checkpoint, the Actor stops using it instead of replaying the cookies through another IP.

Cookies are sensitive and expire. Store them only in the secret input field and export fresh cookies from an account you are authorized to use.

Scope and limitations

• The supported product is public Facebook Pages.
• Personal profiles are best-effort and excluded from the public-Page SLO. They are billed only when they satisfy the same high-value contract.
• Private data is not accessed.
• Facebook can change markup, present login walls, or temporarily block traffic.
• Page contact fields are not guaranteed.

Pricing

Pricing remains $0.01 per usable result. Failed and identity-only outcomes stay out of the default dataset and are not billed as results.

Support

When reporting a problem, share the sanitized SUPPORT_BUNDLE record and the run link. Do not send Facebook cookies or proxy credentials.