Skip to content
scrapeatlas.Dashboard

Social networks

Facebook API

Public Facebook profiles, posts, reels, photos, comments, groups and hashtag posts.

10 endpointsx-api-key

Retrieve public Facebook profiles, posts, reels, photos, comments, transcripts and groups, and discover public posts by hashtag, with pagination, ordered media attachments and video rendition metadata.

API availability: Available

Base URL · local workerhttp://localhost:3039Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/facebook/profile

Get a Facebook profile

Retrieve public profile identity, photos, counts, introduction, contact fields and page transparency, with business hours when published. view=full adds one page of posts and optional computed metrics; format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/profile/reels

List Facebook profile reels

Retrieve one public reels page with video metadata and rounded public view counts. view=full walks up to five pages and adds per-reel engagement; format=camelCase returns camelCase fields under data. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

Reference
GET/v1/facebook/profile/photos

List Facebook profile photos

Retrieve one public photos page with source image URLs and accessibility captions. include=details adds per-photo reads. Enriched post details include ordered media attachments with native IDs and media types. format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/profile/posts

List Facebook profile posts

Retrieve one page of feed posts, newest first, with media, reaction counts, author metadata and continuation. include=engagement adds per-post reads. Includes ordered media attachments with native IDs, GIF types and video rendition metadata. format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/post

Get a Facebook post or reel

Retrieve one public post or reel with available media and engagement; optional comments and transcript reads preserve failures as nulls with warnings. view=transcript returns only the original caption file with SRT/WebVTT/XML cue timing; format=camelCase returns camelCase fields under data. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

Reference
GET/v1/facebook/post/comments

List Facebook post comments

Retrieve a bounded page of top-level comments with author fields, reactions and reply expansion tokens. format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/post/comment/replies

List Facebook comment replies

Retrieve one reply page using a comment feedback ID and expansion token. format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/group

Get a Facebook group

Retrieve a public group summary, activity, rules, visibility, and published administrator/moderator previews. format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/group/posts

List Facebook group posts

Retrieve a public group feed newest first or in another native order, with continuation. Includes ordered media attachments with native IDs, GIF types and video rendition metadata. format=camelCase returns camelCase fields under data.

Reference
GET/v1/facebook/hashtag

Search Facebook posts by hashtag

Discover public Facebook posts tagged with a hashtag, with post text, author, time, engagement counts, ordered media attachments and continuation. Each call returns up to about ten posts.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%2F" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • Independent stateless worker on port 3039. No database, Facebook account, persistent browser session, cache or media hosting. A residential proxy can be configured for public pages that gate direct connections.
  • Two concurrent requests, 60-second overall deadline, 400 upstream requests and 64 MiB decoded source bytes per request, shared by enrichment legs. Fresh browser contexts close after each retrieval.
  • At most 100 records per page, 500,000 traversed nodes and depth 100. Full reels accept at most 50 records across five pages. Auxiliary reads have shorter deadlines and preserve usable partial data.
  • Hashtag reads collect about ten posts per call from at most four source pages; pass the returned cursor for more.
  • Only fixed Facebook public pages, native read-only GraphQL documents, Facebook static scripts and explicitly discovered fbcdn caption URLs are fetched. Service credentials never enter the browser. Media files are not downloaded.
  • cache_max_age and hostMedia are not accepted. Opaque cursors are route-specific; pass back the cursor issued by the route you called.
  • Facebook source changes, regional restrictions and private resources produce explicit failures. Missing counts remain null, never fabricated zeroes.
Error codes
10
HTTPfailure.codeMeaning
200partialUsable data with explicit missing/failed auxiliary coverage.
400invalid_requestMalformed, duplicate, conflicting or unsupported parameters.
401unauthorizedMissing or invalid service API key.
403restricted_pageThe resource is private or restricted.
404not_foundUnknown route or missing resource.
429upstream_rate_limitedFacebook throttled retrieval.
502upstream_challenged upstream_error unsupported_pageSource challenge, failure or unsupported/mismatched structure.
502response_too_large payload_too_complex request_limit unsafe_redirectBounded retrieval or fixed-origin policy failed.
503busyAll Facebook worker slots are occupied.
504timeoutRequest deadline expired.