Facebook API

Fetch public Facebook data with one API

Name: Facebook Data API
Brand: SocialCrawl
Availability: InStock

Fetch public Facebook data as structured JSON with one SocialCrawl API key. Same Post, Comment, and Author schema as every other platform. Reads are priced in credits.

Read the docs How it works Try live

/v1/facebook

23 active endpoints

GET /v1/facebook/profile
GET /v1/facebook/profile/full
GET /v1/facebook/profile/posts
GET /v1/facebook/post
GET /v1/facebook/post/comments
GET /v1/facebook/post/transcript
GET /v1/facebook/adlibrary/search/ads
GET /v1/facebook/adlibrary/ad
GET /v1/facebook/group/posts
GET /v1/facebook/marketplace/search

What Facebook endpoints does SocialCrawl ship?

23 live read endpoints for public Facebook data. Profiles, posts, reels, comments, Ad Library, groups, events, and marketplace search. Data API only.

Profile

1 credit

/v1/facebook/profile

Get Facebook page profile.

url, get_business_hours

Full profile

5 credits

/v1/facebook/profile/full

Facebook profile, recent posts, and computed analytics in one call.

url, posts, cursor, include

Profile posts

1 credit

/v1/facebook/profile/posts

List Facebook page posts.

url, pageId, cursor

Post

1 credit

/v1/facebook/post

Get Facebook post details.

url, get_comments, get_transcript

Post comments

1 credit

/v1/facebook/post/comments

List Facebook post comments.

url, feedback_id, cursor

Post transcript

10 credits

/v1/facebook/post/transcript

Get Facebook video transcript.

url

Ad Library search

5 credits

/v1/facebook/adlibrary/search/ads

Search Facebook Ad Library.

query, sort_by, search_type, ad_type, country

Ad detail

5 credits

/v1/facebook/adlibrary/ad

Get Facebook Ad Library ad details.

id, url, trim

Group posts

1 credit

/v1/facebook/group/posts

List Facebook group posts.

url, group_id, sort_by, cursor

Marketplace search

1 credit

/v1/facebook/marketplace/search

Search Facebook Marketplace listings.

query, lat, lng, radius_km, min_price, max_price

Facebook API24 endpoints supported

View docs

Returns a Facebook page's public profile: page id, display name, profile image, bio, follower count, and page-like count.

Use it when you have a page URL and want a quick snapshot before pulling that page's posts, photos, or reels.

1 credit

GET/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FMeta

url

url · Full URL of the Facebook page or profile

$ curl https://www.socialcrawl.dev/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FMeta \
    -H "x-api-key: sc_YOUR_API_KEY"

idle

// Edit the params above and hit "Try it" to run a live request against the API

How the Facebook API works

Facebook is a normal SocialCrawl social surface. You call GET /v1/facebook/… with an API key, spend credits on live misses, and get a single JSON envelope back. No second SDK.

Authenticate every call

Send your key in the x-api-key header. The same key works across the SocialCrawl catalog.

GET with query params

Routes are GET. Pass handles, urls, queries, and cursors as query strings. We validate formats before charging.

Pay in credits, not seats

Live misses debit the route tier. Cache hits cost 0. Empty or hard failures refund.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached.

The usual integration chain

Most products resolve an account, page content, then deepen only the posts that matter.

01Account

GET /v1/facebook/profile

Author-shaped profile

Resolve the handle or id once.

02Feed

GET /v1/facebook/profile/full

PostList of recent public items

Page with cursor or after when the route supports it.

03Item

GET /v1/facebook/profile/posts

Full Post for one URL or id

List rows are not enough when you need the full record.

04Comments

GET /v1/facebook/post

CommentList when the platform exposes it

Expand only when a thread matters.

request

GET /v1/facebook/profile
  ?url=https://www.facebook.com/Meta
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

response envelope

{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align.

Authorprofile

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postprofile/full

items[].post with id, url, content, engagement, author, published_at, ext

CommentListprofile/posts

items[] with author, content.text, engagement, published_at when comments ship

Search / Mediapost

search hits, media metadata, or transcripts depending on route

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint.

Edge receives the call

Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency.

Validate, then debit

Registry lookup finds the route. Required params run first. Invalid input returns 400 with no charge. Valid calls debit before upstream work.

Cache or fetch

A deterministic cache key is built from platform + resource + params. Hit: credits_used = 0. Miss: upstream fetch with retries and circuit breaker.

Normalize and return

Upstream JSON is mapped to Author / Post / PostList / CommentList (or route archetype), validated, wrapped in the success envelope, and logged for billing audit.

Billing rules that matter in production

Standard live miss: tier cost (often 1 credit)
Advanced reads: typically 5 credits
Premium reads: typically 10 credits
Metered routes: min floor when documented
Cache hit: 0 credits
Empty / hard fail: auto-refund
Bad params: 400, never charged
No credits: 402, never charged
Disabled routes: 503, never charged

How we get the data

Facebook is public-read data on SocialCrawl. We normalize it into the shared schema so your code does not learn a second OAuth flow.

What Facebook is for this API

Public Facebook surfaces exposed by the registry. Read-only for research, monitoring, and product jobs.

How SocialCrawl reaches it

Social-read upstreams behind one gateway. Prism composites combine legs when a fat route is registered.

What leaves our edge

Unified JSON envelope: success, data, credits_used, request_id, cached. Shared Author / Post / Comment leaves where archetypes align.

What we do not ship live

No write endpoints and no private inbox. Disabled routes stay out of the active count. Prefer registry docs for the live inventory.

field map sketch

public profile / channel→ author.*profile identity and counters

public post / media→ post.* / items[].postpost content and engagement

comment page / tree→ CommentList items[]comments or search hits when present

What this API is used for

The jobs this API is most often used for.

23active Facebook endpoints in the registry

1 / 5 / 10credit ladder across standard, advanced, premium

Page monitoring and Ad Library research

Callers concentrate on profile, content lists, search, and deepen paths on Facebook. Organic page reads and Meta Ad Library search on one key and one envelope.

Detail reads are typically a few seconds on live miss. Search and fat composites are slower paths.

What people build with the Facebook API

The jobs Facebook data is most often used for. Each one is a full recipe with the endpoint chain and pricing.

Social listeningPage posts, comments and public event search.

Comment scrapingComments on the page posts and post URLs you already track.

Creator analyticsPage posts and reels, plus re-fetching a known post URL to watch the numbers move.

Identity resolutionPage and profile resolution from a URL, plus the posts that show whether the page is live.

Video transcriptsVideo text for a small share of posts. Available on the same key, and thin enough that it should never carry a workflow on its own.

News and OSINT monitoringPage posts, comments and public event search. Event search is the cleanest endpoint in the product and the one local-incident work depends on.

Ad intelligenceThe deep lane. Company search, company ads, keyword ad search, single ad detail and ad video transcripts, with country, status, media type and date filters that are genuinely used in production.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Monitoring jobs

Python, cron, Slack bots

Poll profiles and feeds on Facebook. Alert when engagement velocity jumps.

Research and VoC

Node, notebooks, BI loads

Search and expand posts for brand, product, and competitor language on Facebook.

Backend product jobs

Go, workers, Explorer

Wire resolve to list to detail into pipelines. Cache hits keep recurring runs cheap.

Call it in two lines

Live misses spend credits by tier. Cache hits are free. Empty or hard failures refund.

curl "https://www.socialcrawl.dev/v1/facebook/profile?url=https://www.facebook.com/Meta" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/facebook/profile/full?url=https://example.com/…" \
  -H "x-api-key: sc_your_api_key_here"

Facebook on SocialCrawl

Same key as the rest of the catalog

Platform docs Get an API key

Endpoints

What data does the Facebook API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

ProfileGet Facebook page profile Profile PostsList Facebook page posts PostGet Facebook post details Post CommentsList Facebook post comments Group PostsList Facebook group posts GroupGet a Facebook group Post TranscriptGet Facebook video transcript Profile PhotosList Facebook profile photos Profile ReelsList Facebook profile reels Adlibrary AdGet Facebook Ad Library ad details Adlibrary Company AdsList Facebook Ad Library company ads Adlibrary Search AdsSearch Facebook Ad Library Adlibrary Search CompaniesSearch Facebook Ad Library companies Profile EventsList a Facebook page's events Post Comment RepliesList replies to a Facebook post comment Marketplace Location SearchSearch Facebook Marketplace locations Marketplace SearchSearch Facebook Marketplace listings Marketplace ItemGet a Facebook Marketplace item Events SearchSearch Facebook events by keyword EventsList Facebook events for a city Event DetailsGet details for a Facebook event Adlibrary Ad TranscriptGet a Facebook Ad Library video ad transcript Profile FullFacebook profile, recent posts, and computed analytics in one call.Profile Reels FullFacebook profile reels with exact views, likes, comments, and shares merged in, in one call.

Comparison

How does SocialCrawl compare to Meta Graph API for Facebook data?

Same Facebook data, two very different paths. Auth, rate limits, schema, and cost, side by side.

Feature	SocialCrawl	Meta Graph API
Authentication	One x-api-key header	Access tokens via Facebook Login, scoped per permission
Setup / approval	Sign up and call in under a minute	Meta developer app, app review, and Business verification for many permissions
Rate limits	Pay per request in credits, with no per-app quota	Per-app and per-user rate limits
Data coverage	Public pages, posts, comments, groups, reels, events, Marketplace, and the Ad Library	Strongest for pages you manage; public-content access is heavily restricted
Response schema	Unified JSON envelope shared across 51 platforms	Graph node-and-edge payloads
Pricing	From 1 credit per request, 100 free credits to start	Free within rate limits
Maintenance	Schema stays stable when Facebook changes its frontend	Official support, plus publishing, insights, and messaging for owned pages

Authentication

SocialCrawl

One x-api-key header

Meta Graph API

Access tokens via Facebook Login, scoped per permission

Setup / approval

SocialCrawl

Meta Graph API

Meta developer app, app review, and Business verification for many permissions

Rate limits

SocialCrawl

Pay per request in credits, with no per-app quota

Meta Graph API

Per-app and per-user rate limits

Data coverage

SocialCrawl

Public pages, posts, comments, groups, reels, events, Marketplace, and the Ad Library

Meta Graph API

Strongest for pages you manage; public-content access is heavily restricted

Response schema

SocialCrawl

Unified JSON envelope shared across 51 platforms

Meta Graph API

Graph node-and-edge payloads

Pricing

SocialCrawl

From 1 credit per request, 100 free credits to start

Meta Graph API

Free within rate limits

Maintenance

SocialCrawl

Schema stays stable when Facebook changes its frontend

Meta Graph API

Official support, plus publishing, insights, and messaging for owned pages

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

How do I scrape Facebook data with an API?

SocialCrawl provides 24 Facebook API endpoints covering profiles, posts, comments, groups, reels, photos, events, Marketplace listings, and the Ad Library. Send a GET request with x-api-key. No Graph API access token, no app review, no Facebook login required.

What Facebook endpoints does SocialCrawl offer?

24 endpoints: Profile, Profile Posts, Post, Post Comments, Group Posts, Group, Post Transcript, Profile Photos, Profile Reels, Ad Library Ad, Ad Library Company Ads, Ad Library Search Ads, Ad Library Search Companies, Profile Events, Post Comment Replies, Marketplace Location Search, Marketplace Search, Marketplace Item, Events Search, Events, Event Details, Ad Library Ad Transcript, Profile Full, and Profile Reels Full.

How much does the Facebook API cost?

Most Facebook endpoints cost 1 credit on the standard tier. Ad Library endpoints cost 5 credits (advanced tier) and post transcripts cost 10 credits (premium). New accounts get 100 free credits, no credit card required.

Do I need a Facebook Graph API access token?

No. SocialCrawl works without a Graph API token, app review, or Facebook login. Pass your SocialCrawl x-api-key and the URL. The response comes back in a unified schema that stays consistent across every endpoint.

Is it legal to scrape Facebook with this API?

SocialCrawl accesses only publicly available Facebook data through our upstream provider. You are responsible for complying with Facebook's terms of service and applicable data protection regulations in your use case. SocialCrawl operates under a documented GDPR legitimate-interest framework: public, logged-out data only, no credential use, short-lived caches (2 to 30 minutes) with no persistent store, and a public opt-out channel for anyone whose public info appears in responses. Full details: socialcrawl.dev/legal/public-data-notice.

Can I pull Facebook Ad Library data for competitor research?

Yes. Four endpoints wrap the Facebook Ad Library: fetch a specific ad, list all ads from a company, search ads by keyword, and search for advertiser companies. Perfect for ad intelligence and competitor monitoring.

What is the best Facebook scraper API?

SocialCrawl is built for public Facebook data: 24 endpoints spanning pages, posts, comments, groups, reels, events, Marketplace, and the Ad Library behind one x-api-key, from 1 credit per request with 100 free credits on signup. If you need to publish posts or read insights for pages you own, the Meta Graph API fits better.

Does Facebook have a data API?

Facebook has the Meta Graph API, but it is strongest for pages you manage and heavily restricts public-content access, so SocialCrawl serves as the practical Facebook data API for reading public data. SocialCrawl returns public pages, posts, comments, groups, reels, photos, events, Marketplace listings, and the full Ad Library as unified JSON from one x-api-key. There is no Graph API token, app review, or Business verification to clear, and pricing starts from 1 credit per request with 100 free credits on signup.

Facebook scraping API vs the official Facebook API: what's the difference?

With SocialCrawl there is no app review or approval queue. Sign up and call Facebook endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Read the Facebook API reference in the docs

🤖 AI agent or LLM? Read this page as markdown