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

> Returns Facebook page or profile photos as unified Post items. Each item includes a photo ID, permalink, full-size image URL, thumbnail, and accessibility caption when available. Per-item author, engagement counts, and publish time are not exposed, so those canonical fields and engagement counts remain null.

TL;DR: `GET /v1/facebook/profile/photos` 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` | yes | Full URL of the Facebook page or profile |
| `next_page_id` | no | To paginate through to the next page |
| `cursor` | no | To paginate through to the next page |

## Code example

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

## FAQ

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

Send a GET request to /v1/facebook/profile/photos with the page url. SocialCrawl returns an array of photos with image URL, caption, reaction count, comment count, and upload timestamp for each.

### Do I get full-resolution image URLs?

Yes. The response returns Facebook's hosted image URLs at display resolution, the same URLs rendered on the page. Use them directly in an <img> tag, download them for archival, or feed them into image analysis models.

### How do I paginate through all photos on a page?

Pass the cursor (or next_page_id) from the previous response as the next request's cursor parameter. Repeat until cursor is empty to walk the page's entire public photo album.

### Does this include photos from posts with images?

This endpoint returns photos from the page's dedicated photo feed. For photos attached to regular posts, use /v1/facebook/profile/posts. Each post object includes its media attachments inline.

### Can I use these images in my product?

Image URLs are returned as-is from Facebook. Using them commercially requires you to respect Facebook's terms and the original creator's rights. SocialCrawl surfaces the data; licensing and rights clearance is your responsibility.

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 photos with an API
- Does SocialCrawl return full-resolution Facebook images?