Facebook API reference
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.
The Facebook API has 16 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Facebook in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The input most of them take is url. Prices run from 1 credit to 3 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
facebook.page.get |
Get a public page from its link: name, category, about text, followers and how many people are talking about it. | 2 credits |
facebook.page-posts.list |
List a page's recent posts with text, post time, reactions by type, comments and shares. | 2–5 credits |
facebook.post.get |
Get one post from its link: text, reactions, shares and comment count. | 1 credit |
facebook.post-comments.list |
Read the public comments shown on a post, most relevant first, with text, date, reactions and reply counts. | 1.5 credits |
facebook.comment-replies.list |
Read the public replies to one comment, from the comment's link. | 1.5 credits |
facebook.ads-library.search |
Search the public Ads Library by advertiser or keyword, by country and by active or ended ads. | 1 credit |
facebook.page-videos.list |
List the videos on a page's Videos tab, newest first, with titles, post dates and views. | 1.5–3 credits |
facebook.page-reels.list |
List a page's recent reels with text, length, plays and post time. | 1 credit |
facebook.video.get |
Get one public video from its link: title, views, likes, reactions and comments. | 1 credit |
facebook.reel.get |
Get one public reel from its link: title, views, likes, reactions and comments. | 1 credit |
facebook.video-transcript.get |
Get the captions of a video or reel as timed lines and full text, when it has captions. | 1 credit |
facebook.page-about.get |
Get a page's About details: categories, websites and the contact details the page shows publicly. | 1 credit |
facebook.page-photos.list |
List the recent photos on a page's Photos tab with caption, size and link. | 1 credit |
facebook.page-events.list |
List a page's upcoming or past public events with name, start time and place. | 1 credit |
facebook.event.get |
Get one public event: name, start time, place or online, the page running it, description and how many responded. | 1 credit |
facebook.group.get |
Get a group's public profile: name, privacy, member count and description. | 3 credits |
What to know
- What a visitor sees Every call reads what Facebook shows to someone who is not signed in. Private profiles and private groups' posts are not part of it.
- Comments are the top ones Facebook shows visitors the most relevant comments on a post. Replies are counted there, and readable one comment at a time.
- Counts as Facebook shows them Followers, reactions and plays are Facebook's own numbers at the moment of the call. Some, like plays, Facebook rounds.
- Captions come from the video Transcripts are the captions a video already has. A video without captions has no transcript to return.
Something missing or unclear? Ask the team that builds the Facebook endpoints.