# Facebook Data API (https://www.socialcrawl.dev/platforms/facebook)

> Facebook data API: 23 endpoints for profiles, posts, comments, groups, reels, photos, events, Marketplace listings, and the full Ad Library: ads, advertiser search, and ad transcripts. From 1 credit per request, 100 free credits on signup, no credit card. One x-api-key header instead of Graph API tokens, app review, or Business verification.

TL;DR: SocialCrawl's Facebook API exposes 23 endpoints, 1 to 10 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Profile | GET | `/v1/facebook/profile` | 1 | Get Facebook page profile |
| Profile Posts | GET | `/v1/facebook/profile/posts` | 1 | List Facebook page posts |
| Post | GET | `/v1/facebook/post` | 1 | Get Facebook post details |
| Post Comments | GET | `/v1/facebook/post/comments` | 1 | List Facebook post comments |
| Group Posts | GET | `/v1/facebook/group/posts` | 1 | List Facebook group posts |
| Post Transcript | GET | `/v1/facebook/post/transcript` | 10 | Get Facebook video transcript |
| Profile Photos | GET | `/v1/facebook/profile/photos` | 1 | List Facebook profile photos |
| Profile Reels | GET | `/v1/facebook/profile/reels` | 1 | List Facebook profile reels |
| Adlibrary Ad | GET | `/v1/facebook/adlibrary/ad` | 5 | Get Facebook Ad Library ad details |
| Adlibrary Company Ads | GET | `/v1/facebook/adlibrary/company/ads` | 5 | List Facebook Ad Library company ads |
| Adlibrary Search Ads | GET | `/v1/facebook/adlibrary/search/ads` | 5 | Search Facebook Ad Library |
| Adlibrary Search Companies | GET | `/v1/facebook/adlibrary/search/companies` | 5 | Search Facebook Ad Library companies |
| Profile Events | GET | `/v1/facebook/profile/events` | 1 | List a Facebook page's events |
| Post Comment Replies | GET | `/v1/facebook/post/comment/replies` | 1 | List replies to a Facebook post comment |
| Marketplace Location Search | GET | `/v1/facebook/marketplace/location/search` | 1 | Search Facebook Marketplace locations |
| Marketplace Search | GET | `/v1/facebook/marketplace/search` | 1 | Search Facebook Marketplace listings |
| Marketplace Item | GET | `/v1/facebook/marketplace/item` | 1 | Get a Facebook Marketplace item |
| Events Search | GET | `/v1/facebook/events/search` | 1 | Search Facebook events by keyword |
| Events | GET | `/v1/facebook/events` | 1 | List Facebook events for a city |
| Event Details | GET | `/v1/facebook/event/details` | 1 | Get details for a Facebook event |
| Adlibrary Ad Transcript | GET | `/v1/facebook/adlibrary/ad/transcript` | 10 | Get a Facebook Ad Library video ad transcript |
| Profile Full | GET | `/v1/facebook/profile/full` | 5 | Facebook profile, recent posts, and computed analytics in one call. |
| Profile Reels Full | GET | `/v1/facebook/profile/reels/full` | 5 | Facebook profile reels with exact views, likes, comments, and shares merged in, in one call. |

## Code example

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

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Meta Graph API

| 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 44 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 |

## FAQ

### How do I scrape Facebook data with an API?

SocialCrawl provides 23 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?

23 endpoints: Profile, Profile Posts, Post, Post Comments, Group Posts, 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: 23 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.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What is the SocialCrawl Facebook API?
- How to scrape Facebook data without the Graph API
- Compare SocialCrawl vs Apify for Facebook scraping