↑ ↓ to move ↵ to open
Social & content · REST API · MCP server

Facebook Scraper API

Get public Facebook pages, posts, comments, videos, reels, events and Ads Library results as clean JSON. Send a page or post link, or a search. No Facebook login.

  • 1 credit per call
  • Failed calls are free
  • Updated
facebook.page.get completed
namestringMeta
category_namestringCompany
descriptionstringConnect with what you love to make things happen.
follower_countinteger106,783,063
talking_about_countinteger256,084
urlstringhttps://www.facebook.com/Meta/
idstring108824017345866
Endpoints

Facebook API endpoints

What each one takes and what it returns. Open one for a real response, every input and every field.

Facebook Page API

Get a public page from its link: name, category, about text, followers and how many people are talking about it.

Sendurl Returnsnamecategory_namedescriptionfollower_counttalking_about_counturl
1 credit

Facebook Page Posts API

List a page's recent posts with text, post time, reactions by type, comments and shares.

Sendurl Returnstextreactionscomment_countshare_countcreated_timeurl
1 credit

Facebook Post API

Get one post from its link: text, reactions, shares and comment count.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Post Comments API

Read the public comments shown on a post, most relevant first, with text, date, reactions and reply counts.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Comment Replies API

Read the public replies to one comment, from the comment's link.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Ads Library Search API

Search the public Ads Library by advertiser or keyword, by country and by active or ended ads.

Sendquery Returnsad_archive_idad_idcategoriescollation_countcollation_idcontains_digital_created_media
1 credit

Facebook Page Videos API

List the videos on a page's Videos tab, newest first, with titles, post dates and views.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Page Reels API

List a page's recent reels with text, length, plays and post time.

Sendurl Returnstextplay_countduration_mscreated_aturlreel_id
1 credit

Facebook Video API

Get one public video from its link: title, views, likes, reactions and comments.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Reel API

Get one public reel from its link: title, views, likes, reactions and comments.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Video Transcript API

Get the captions of a video or reel as timed lines and full text, when it has captions.

Sendurl Returnstextend_msstart_ms
1 credit

Facebook Page About Information API

Get a page's About details: categories, websites and the contact details the page shows publicly.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Page Photos API

List the recent photos on a page's Photos tab with caption, size and link.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Photo API

Get one public photo from a page: the image, caption and engagement.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Page Events API

List a page's upcoming or past public events with name, start time and place.

Sendurl Returnsnamestart_athost_nameis_pastis_canceledurl
1 credit

Facebook Event API

Get one public event: name, start time, place or online, the page running it, description and how many responded.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Facebook Group API

Get a group's public profile: name, privacy, member count and description.

Sendurl ReturnsJSON; every field is in the API reference
1 credit
Use cases

What teams build with Facebook data

Know before you build

How Facebook data behaves

REST API · MCP server

Call it from your code, or ask your agent

One request shape for every Facebook endpoint: the endpoint ID and its input. No SDK needed.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "facebook.page.get",  "input": {    "url": "https://www.facebook.com/Meta"  }}'
Response
{  "name": "Meta",  "follower_count": 106783063,  "category_name": "Company",  "description": "Connect with what you love to make things happen.",  "id": "108824017345866",  "talking_about_count": 256084,  "url": "https://www.facebook.com/Meta/"}
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

Use Upscrape to look up Meta's Facebook page (facebook.com/Meta). How many followers does it have, and how many people are talking about it?

With Upscrape, get Meta's latest Facebook posts and make a table of text, likes, comments and shares. Which posts got the most likes?

Using Upscrape, list Meta's recent Facebook reels with plays and length, most played first.

The agent finds the endpoint, shows you the price, and runs it with your credits.
Social & content
Questions

Facebook Scraper API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
Is there an official Facebook API for this data?

Meta's Graph API covers pages and ads you manage, after app review. Upscrape reads public Facebook pages, so you can get any public page's posts, reels and events, and search the Ads Library, with one API key.

Do I need a Facebook account?

No. You send a link or a search and get JSON back. Nothing runs on your account, and you share no password or cookie.

Can I get every post a page has made?

You get the recent posts Facebook shows visitors, about the latest 20. Call it on a schedule to build a history from then on.

What data can I get from Facebook?

Page, page posts, post, post comments, comment replies, ads library search, page videos, page reels, video, reel, video transcript, page about information, page photos, photo, page events, event and group. Each is its own endpoint with a published input schema, and the response is JSON.

How much does the Facebook API cost?

Every Facebook endpoint costs 1 credit per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.

Can an AI agent use the Facebook API?

Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the Facebook endpoint, checks its price and runs it with the same credits as the REST API.

Is it legal to scrape Facebook?

Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.

What happens when Facebook changes its pages?

We fix the endpoint. Your request and the response fields stay the same.

Get started

Your first Facebook call is free.

Up to 100 free credits to start, no card needed.