Facebook scraper API

Scrapes public Facebook data including pages, posts, events, videos, reviews, and ads library.

Social & content 10 capabilities stable 99.8% success rate

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Search Ads Library


            facebook.ads-library.search

1 credit / request Endpoint docs Copy coding prompt

Searches the Facebook Ads Library for active and inactive ads by advertiser or keyword.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"Meta AI"},"capability":"facebook.ads-library.search"}'

Input

Field	Type	Required	Description
`cursor`	string	optional	Pagination cursor from previous response
`limit`	integer	optional	Maximum number of results to return
`query`	string	required	Search query string

List Page Posts


            facebook.page-posts.list

1 credit / request Endpoint docs Copy coding prompt

Lists recent posts from a Facebook page including text, media, and engagement metrics.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page-posts.list"}'

Input

Field	Type	Required	Description
`cursor`	string	optional	Pagination cursor from previous response
`limit`	integer	optional	Maximum items per page
`url`	string	required	Page URL

List Page Reels


            facebook.page-reels.list

1 credit / request Endpoint docs Copy coding prompt

Lists reels from a Facebook page with view counts and video metadata.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page-reels.list"}'

Input

Field	Type	Required	Description
`limit`	integer	optional	Maximum items to return
`url`	string	required	Page URL

List Page Videos


            facebook.page-videos.list

1 credit / request Endpoint docs Copy coding prompt

Lists videos posted by a Facebook page with titles, view counts, and engagement metrics.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page-videos.list"}'

Input

Field	Type	Required	Description
`cursor`	string	optional	Pagination cursor from previous response
`limit`	integer	optional	Maximum items per page
`url`	string	required	Page URL

Get Page


            facebook.page.get

1 credit / request Endpoint docs Copy coding prompt

Fetches a Facebook page's public profile including name, category, follower count, and page metadata.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta"},"capability":"facebook.page.get"}'

Input

Field	Type	Required	Description
`url`	string	required	Resource URL to scrape

Get Photo


            facebook.photo.get

1 credit / request Endpoint docs Copy coding prompt

Fetches details about a public Facebook photo including image URL and engagement metadata.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/NASA/photos/1496429658519072"},"capability":"facebook.photo.get"}'

Input

Field	Type	Required	Description
`url`	string	required	Photo URL

List Post Comments


            facebook.post-comments.list

1 credit / request Endpoint docs Copy coding prompt

Lists comments on a Facebook post including comment text, author, and reaction counts.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta/posts/pfbid0EwsxFj5K4PGG5XS58NxrZwEYgrx4aWwnSYJdFVsphLZDJMPXYiokrkefu1CmKm4Vl"},"capability":"facebook.post-comments.list"}'

Input

Field	Type	Required	Description
`cursor`	string	optional	Pagination cursor from previous response
`limit`	integer	optional	Maximum items per page
`url`	string	required	Post URL

Get Post


            facebook.post.get

1 credit / request Endpoint docs Copy coding prompt

Fetches a Facebook post's details including text, reactions, shares, and comment count.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta/posts/pfbid0EwsxFj5K4PGG5XS58NxrZwEYgrx4aWwnSYJdFVsphLZDJMPXYiokrkefu1CmKm4Vl"},"capability":"facebook.post.get"}'

Input

Field	Type	Required	Description
`url`	string	required	Post URL

Get Reel


            facebook.reel.get

1 credit / request Endpoint docs Copy coding prompt

Fetches details about a public Facebook Reel including video URL, view count, and engagement.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/reel/911507208162880"},"capability":"facebook.reel.get"}'

Input

Field	Type	Required	Description
`url`	string	required	Resource URL to scrape

Get Video


            facebook.video.get

1 credit / request Endpoint docs Copy coding prompt

Fetches details about a public Facebook video including title, view count, and engagement metrics.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.facebook.com/Meta/videos/911507208162880/"},"capability":"facebook.video.get"}'

Input

Field	Type	Required	Description
`url`	string	required	Resource URL to scrape

Run Facebook in under a minute

Get an API key