# Facebook Profile Posts API (https://www.socialcrawl.dev/platforms/facebook/profile-posts)

> Returns a list of recent posts from a Facebook page or profile. Each post includes the post text, like count, comment count, share count, media attachments, and publish timestamp.

TL;DR: `GET /v1/facebook/profile/posts` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | no | Full URL of the Facebook page or profile to fetch posts for |
| `pageId` | no | Facebook profile page id |
| `cursor` | no | To paginate through the posts |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/facebook/profile/posts" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list posts from a Facebook page?

Send a GET request to /v1/facebook/profile/posts with either url or pageId. SocialCrawl returns an array of recent posts including text, like count, comment count, share count, media attachments, and publish timestamp.

### What fields does each post include?

Every post has its id, text content, like count, comment count, share count, publish timestamp, author info, and any media attachments (images, videos, links). Field names stay consistent across all SocialCrawl platforms.

### How do I paginate through older posts?

Take the cursor value from the response and pass it as the cursor parameter on the next request. Repeat until the cursor is empty — you can walk through hundreds of posts without hitting the Graph API's pagination limits.

### Can I use pageId instead of the page URL?

Yes. The endpoint accepts either url or pageId as the identifier. If you already have Facebook page IDs in your database, pass pageId directly — it's slightly faster than resolving the URL on each request.

### Does the endpoint return video posts and reels?

Yes, video and reel posts appear in the response with their media URLs and view counts. For reels-specific data, use /v1/facebook/profile/reels. For a dedicated photo feed, use /v1/facebook/profile/photos.

See the full Facebook API: https://www.socialcrawl.dev/platforms/facebook

## 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:

- How to list Facebook page posts with an API
- What data does SocialCrawl return for Facebook posts?