# Facebook API

Extract public Facebook pages, content, engagement metrics, and Ads Library results.

- Platform ID: `facebook`
- Capabilities: 17
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [Search Ads Library](https://docs.upscrape.com/docs/platforms/facebook/facebook.ads-library.search)

- Capability ID: `facebook.ads-library.search`
- Cost: 1 credit per request

Searches the public Facebook Ads Library by advertiser or keyword, filtered by country and active or inactive status.
### [List comment replies](https://docs.upscrape.com/docs/platforms/facebook/facebook.comment-replies.list)

- Capability ID: `facebook.comment-replies.list`
- Cost: 1 credit per request

Return a bounded public sample of replies from one verified Facebook comment permalink, preserving the root and direct parent identity.
### [Get event](https://docs.upscrape.com/docs/platforms/facebook/facebook.event.get)

- Capability ID: `facebook.event.get`
- Cost: 1 credit per request

Fetches a public Facebook event with name, exact start time, place or online status, host page, description, and responded count.
### [Get group](https://docs.upscrape.com/docs/platforms/facebook/facebook.group.get)

- Capability ID: `facebook.group.get`
- Cost: 1 credit per request

Fetches a Facebook group's public profile: name, privacy, member count, and description.
### [Get page about information](https://docs.upscrape.com/docs/platforms/facebook/facebook.page-about.get)

- Capability ID: `facebook.page-about.get`
- Cost: 1 credit per request

Fetches the public About details of a Facebook page: categories, websites, and available contact fields.
### [List page events](https://docs.upscrape.com/docs/platforms/facebook/facebook.page-events.list)

- Capability ID: `facebook.page-events.list`
- Cost: 1 credit per request

Lists upcoming or past public events hosted by a Facebook page with name, start time, place, and host.
### [List page photos](https://docs.upscrape.com/docs/platforms/facebook/facebook.page-photos.list)

- Capability ID: `facebook.page-photos.list`
- Cost: 1 credit per request

Lists recent photos from a Facebook page's public Photos tab with image size, caption, and permalink.
### [List page posts](https://docs.upscrape.com/docs/platforms/facebook/facebook.page-posts.list)

- Capability ID: `facebook.page-posts.list`
- Cost: 1 credit per request

Lists recent posts from a Facebook page with text, publish date, media, reactions by type, comments, and shares.
### [List page Reels](https://docs.upscrape.com/docs/platforms/facebook/facebook.page-reels.list)

- Capability ID: `facebook.page-reels.list`
- Cost: 1 credit per request

Lists reels from a Facebook page with view counts and video metadata.
### [List page videos](https://docs.upscrape.com/docs/platforms/facebook/facebook.page-videos.list)

- Capability ID: `facebook.page-videos.list`
- Cost: 1 credit per request

Lists videos from a Facebook page's public Videos tab, newest first, with titles, publish dates, and view counts.
### [Get page](https://docs.upscrape.com/docs/platforms/facebook/facebook.page.get)

- Capability ID: `facebook.page.get`
- Cost: 1 credit per request

Fetches a public Facebook page and its available follower, page-like, and talking-about counts.
### [Get photo](https://docs.upscrape.com/docs/platforms/facebook/facebook.photo.get)

- Capability ID: `facebook.photo.get`
- Cost: 1 credit per request

Fetches details about a public Facebook photo including image URL and engagement metadata.
### [List post comments](https://docs.upscrape.com/docs/platforms/facebook/facebook.post-comments.list)

- Capability ID: `facebook.post-comments.list`
- Cost: 1 credit per request

Lists public top-level comments on a Facebook post with text, date, reactions, and reply counts.
### [Get post](https://docs.upscrape.com/docs/platforms/facebook/facebook.post.get)

- Capability ID: `facebook.post.get`
- Cost: 1 credit per request

Fetches a Facebook post's details including text, reactions, shares, and comment count.
### [Get Reel](https://docs.upscrape.com/docs/platforms/facebook/facebook.reel.get)

- Capability ID: `facebook.reel.get`
- Cost: 1 credit per request

Fetches a public Facebook Reel with normalized title, views, likes, reactions, and comments.
### [Get video transcript](https://docs.upscrape.com/docs/platforms/facebook/facebook.video-transcript.get)

- Capability ID: `facebook.video-transcript.get`
- Cost: 1 credit per request

Returns the public captions of a Facebook video or Reel as timed segments and full text, when the video has captions.
### [Get video](https://docs.upscrape.com/docs/platforms/facebook/facebook.video.get)

- Capability ID: `facebook.video.get`
- Cost: 1 credit per request

Fetches a public Facebook video with normalized title, views, likes, reactions, and comments.

## Common uses

- Monitor public page audiences and engagement
- Analyze posts, comments, videos, and Reels
- Research active Facebook advertising

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).