Skip to content

scrapeatlas.Dashboard

Social networks

Facebook API

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

22 endpointsx-api-key

Retrieve public Facebook profiles, posts, reels, photos, comments, transcripts and groups, 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/full

Get a Facebook profile with posts

Retrieve the critical profile plus one page of posts and optional computed metrics. Per-leg status preserves post failures without losing a usable profile. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/profile/reels/full

List Facebook profile reels with engagement

Walk up to five reels pages, capped at 50 records, and retrieve per-reel engagement where available. Item coverage and a continuation cursor expose incomplete enrichment. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/profile

Get a Facebook profile

Retrieve public profile identity, photos, counts, introduction, contact fields and page transparency. Business hours are included when the page publishes them.

GET/v1/facebook/profile/reels

List Facebook profile reels

Retrieve one public reels page with video metadata and rounded public view counts. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

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.

GET/v1/facebook/profile/posts

List Facebook profile posts

Retrieve one page of feed posts, 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.

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. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/post/transcript

Get a Facebook post transcript

Retrieve the original public caption file, preserving SRT/WebVTT/XML cue timing, line breaks and text.

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.

GET/v1/facebook/post/comment/replies

List Facebook comment replies

Retrieve one reply page using a comment feedback ID and expansion token.

GET/v1/facebook/group

Get a Facebook group

Retrieve a public group summary, activity, rules, visibility, and published administrator/moderator previews.

GET/v1/facebook/group/posts

List Facebook group posts

Retrieve a public group feed in the requested native order, with continuation. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/profiles

Get a Facebook profile via /profiles

Retrieve public profile identity, photos, counts, introduction, contact fields and page transparency. Business hours are included when the page publishes them.

GET/v1/facebook/profiles/posts

List Facebook profile posts via /profiles

Retrieve one page of feed posts, 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.

GET/v1/facebook/profiles/reels

List Facebook profile reels via /profiles

Retrieve one public reels page with video metadata and rounded public view counts. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/profiles/photos

List Facebook profile photos via /profiles

Retrieve one public photos page with source image URLs and accessibility captions. include=details adds per-photo reads.

GET/v1/facebook/posts

Get a Facebook post or reel via /posts

Retrieve one public post or reel with available media and engagement. Optional comments and transcript reads preserve failures as nulls with warnings. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/posts/comments

List Facebook post comments via /posts

Retrieve a bounded page of top-level comments with author fields, reactions and reply expansion tokens.

GET/v1/facebook/posts/comments/replies

List Facebook comment replies via /posts

Retrieve one reply page using a comment feedback ID and expansion token.

GET/v1/facebook/posts/transcript

Get a Facebook post transcript via /posts

Retrieve the original public caption file, preserving SRT/WebVTT/XML cue timing, line breaks and text.

GET/v1/facebook/groups

Get a Facebook group via /groups

Retrieve a public group summary, activity, rules, visibility, and published administrator/moderator previews.

GET/v1/facebook/groups/posts

List Facebook group posts via /groups

Retrieve a public group feed in the requested native order, with continuation. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

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/full?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%2F&posts=3" \
  -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.
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

HTTP	failure.code	Meaning
200	`partial`	Usable data with explicit missing/failed auxiliary coverage.
400	`invalid_request`	Malformed, duplicate, conflicting or unsupported parameters.
401	`unauthorized`	Missing or invalid service API key.
403	`restricted_page`	The resource is private or restricted.
404	`not_found`	Unknown route or missing resource.
429	`upstream_rate_limited`	Facebook throttled retrieval.
502	`upstream_challenged` `upstream_error` `unsupported_page`	Source challenge, failure or unsupported/mismatched structure.
502	`response_too_large` `payload_too_complex` `request_limit` `unsafe_redirect`	Bounded retrieval or fixed-origin policy failed.
503	`busy`	All Facebook worker slots are occupied.
504	`timeout`	Request deadline expired.