Facebook data API and MCP for AI agents
TollNode gives Claude, Cursor or any AI agent live public Facebook data (pages, posts, reviews, events and the Meta ad library) over API and MCP, from $0.013 per call.
Ask in plain words, like 'show Nike's latest posts with likes and comments', and get a clean table back in seconds.
No subscription · Sign-up optional · From $0.013 per call · Charged only when it works · No Facebook account needed
Look up National Geographic's Facebook page and tell me their category, followers and website
TollNode · Facebook · page$0.013 · 1 page · 35 s
| Field | Value |
|---|---|
| Name | National Geographic |
| Category | Media/news company |
| Followers | 51,448,485 |
| Website | nationalgeographic.com |
Real result.
What your agent can pull from Facebook
- from $0.013
Pages
Facebook page data API
A public page's profile, reach and contact details.
- Page
- National Geographic
- Category
- Media/news company
- Followers
- 51,448,485
- Website
- nationalgeographic.com
- Created
- August 7, 2008
You get
- category: the page's listed category
- intro: short description the page shows
- followers: follower count
- likes: like count
- website: the page's own site
- address: listed address or map link
- phone and email: contact details where published
- creation_date: when the page was created
- from $0.057
Posts and comments
The latest 10 posts, or 20 comments on one post.
- Page
- Nike
- Posted
- Sep 4, 2024
- Text
- That's one giant leap for humankind...
- Likes
- 5,104
- Comments
- 488
You get
- text: the post or comment itself
- date: when it was posted
- likes: like count
- comments: comment count on a post
- shares: repost count
- reactions: counts by reaction type
- media: photo or video links
- commenter: name of who commented
- from $0.057
Reviews
20 reviews of a page, recommended or not.
- Recommends
- Yes
- Review
- I purchased tacos at the food truck... they were delicious.
- Date
- Nov 11, 2025
- Likes
- 0
- Comments
- 1
You get
- recommended: yes or no recommendation
- text: the review text
- tags: topics the reviewer tagged
- reviewer: name of the reviewer
- likes: likes on the review
- date: when it was posted
- from $0.022
Events and ads
Public events by city or topic, and live Meta ads.
- Page
- Allbirds
- Platforms
- Active
- Yes
- Start date
- Oct 30, 2026
- Total ads found
- 67
You get
- name: the event's title
- date and time: when the event happens
- place: venue or location
- ticket link: where to get tickets
- attendees: going and interested counts
- ad text: the ad's body copy
- platforms: Facebook, Instagram or both
- is_active: whether the ad is still running
Every result is structured JSON your agent can sort, filter, summarize or turn into a spreadsheet.
What people ask their AI to do with it
Marketing
Track a competitor's live ad campaigns
“What Facebook and Instagram ads is Allbirds running right now?”
ads
Cost today$0.022
Sales
Check a lead's page before reaching out
“Look up Shake Shack's Facebook page: category, followers and contact info”
page
Cost today$0.013
Social media managers
See what a brand just posted
“What has National Geographic posted on Facebook this week, and what are people saying in the comments?”
posts + comments
Cost today$0.114
Event organizers
Find local events worth promoting
“Find jazz events in Austin this weekend on Facebook”
events
Cost today$0.138
Customer support
Check if customers are happy
“Pull the latest Facebook reviews for Shake Shack and tell me if customers are happy”
reviews
Cost today$0.057
Investors
Brief me on a brand in a minute
“Brief me on Allbirds: their Facebook page, recent posts and current ads”
page + posts + ads
Cost today$0.092
Use it as a Facebook MCP server in Claude, Cursor or Codex
Connect once. Then just ask.
Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.
npx agentcash add https://tollnode.comCopy for your AI agent
Paste this into your agent so it knows what this node does and how to call it.
You can use TollNode's Facebook node to look up public Facebook data. Call POST https://tollnode.com/api/v1/nodes/facebook with an "action" and its fields. Actions: page (handle), posts (handle), comments (url), reviews (handle), events (query), ads (query, country). Each action has its own price and is charged only when it returns a result. Over MCP, call the "facebook" tool; use list_models to see prices. Return results as tables when I ask for lists.6 actions, one node
Send action plus the fields that action needs, to the same address. Each action has its own price, charged only when it returns a result. Leave out action and you get page.
- page$0.013
A page's profile, followers, category and contact details. Page name, category, intro, likes, followers, website, address, phone and email where published, and creation date..
needs: handle
- posts$0.057
A page's latest 10 posts. 10 posts: text, date, likes, comments, shares, reaction counts, media links and post link..
needs: handle
- comments$0.057
20 comments on a post or reel. 20 comments: text, commenter name, likes, reply count and date..
needs: url
- reviews$0.057
20 reviews of a page. 20 reviews: recommended or not, text, tags, reviewer name, likes and date..
needs: handle
- events$0.138
10 public events for a search like jazz Austin. 10 events: name, date and time, place, description, organiser, ticket link and how many people are going or interested..
needs: query
- ads$0.022
20 active Facebook and Instagram ads for a brand or keyword. 20 ads: page name, ad text, headline, image and video links, call to action, start date, platforms and active flag..
needs: query · optional: country
{"action":"page","handle":"natgeo"}{"action":"posts","handle":"natgeo"}POST either body to https://tollnode.com/api/v1/nodes/facebook. From an AI assistant you don't write this yourself: ask in plain words and it picks the action.
Charged only when a call returns a result. Failed or empty calls cost $0.
Facebook data without a scraper or app review
No subscription, no credit packs
Pay per action: a page lookup is $0.013, a 20-review pull is $0.057.
No scraper, no Facebook account, no app review
Your own account is never touched and there's no Graph API approval to wait for.
Only charged when it works
If a page or handle isn't found, it costs nothing.
One connection, much more than Facebook
The same setup also gives your agent Instagram, Google search, Maps reviews and image and video models.
FAQ
- Is this the official Facebook API?
- No. Meta's official Graph API needs an approved app and mostly covers pages you manage. TollNode returns public Facebook page, post, review, event and ad library data through its own API and MCP server, priced per call.
- Can I use it as a Facebook MCP server in Claude?
- Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the "facebook" tool appears with every action and its price.
- Do I need a Facebook account?
- No. Your agent calls TollNode, and you never log in to Facebook or share cookies.
- Can this read private groups, Marketplace or personal profiles?
- No. This node only covers public pages, their posts, comments, reviews, public events and the Meta ad library.
- What if a page or handle isn't found?
- You're not charged. The response says nothing was found, and your agent can try a different handle or URL.
- How does the ad library search work?
- The ads action returns up to 20 active Facebook and Instagram ads for a brand or keyword, with text, media, start date and platforms.
- How much data comes back per call?
- Posts return the latest 10, comments and reviews return 20, events return 10 and ads return 20. Ask for another search to get more.
Works well with
- Instagram data: profiles, posts and commentsCheck the same brand's Instagram profile and postsfrom $0.005
- Meta ad library searchDig deeper into one brand's ad history$0.022
- Google Maps business searchCompare against the business's Google Maps listing$0.042
- Google data: web, news, trends, Maps, adsWeb and news search on the same companyfrom $0.014
Ready in a minute
Connect your AIFor developers: endpoint, inputs and an example response
POST https://tollnode.com/api/v1/nodes/facebook
Input
| Field | Type | Notes |
|---|---|---|
| url | string | A public Facebook post or reel URL (for: comments) |
| query | string | What and where, e.g. jazz Austin (for: events, ads) |
| action* | enum | What to do; sets the price. page (needs handle), posts (needs handle), comments (needs url), reviews (needs handle), events (needs query), ads (needs query). Default page (page, posts, comments, reviews, events, ads) |
| handle | string | Facebook page name as in its URL, e.g. natgeo (for: page, posts, reviews) |
| country | string | Two-letter country code, uppercase, e.g. US, GB, DE; default US (for: ads) |
Example response
{
"results": [
{
"intro": "Step into wonder and find your inner explorer with National Geographic 🌎",
"likes": 0,
"title": "National Geographic",
"pageId": "100044623170418",
"address": "https://www.bing.com/maps/default.aspx?v=2&pc=FACEBK&mid=8100&FORM=FBKPL1&mkt=en-US",
"pageUrl": "https://www.facebook.com/natgeo",
"website": "http://www.nationalgeographic.com/",
"category": "Media/news company",
"pageName": "natgeo",
"ad_status": "This Page is currently running ads.",
"followers": 51448485,
"messenger": null,
"addressUrl": "https://www.bing.com/maps/default.aspx?v=2&pc=FACEBK&mid=8100&FORM=FBKPL1&mkt=en-US",
"facebookId": "100044623170418",
"followings": 2,
"facebookUrl": "https://www.facebook.com/natgeo",
"profilePhoto": "https://www.facebook.com/photo/?fbid=1182307926599969&set=a.528642305299871",
"coverPhotoUrl": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/812781747_1736507274317264_838409908249726649_n.png?stp=dst-jpg_tt…",
"creation_date": "August 7, 2008",
"confirmed_owner": "NATIONAL GEOGRAPHIC PARTNERS, LLC is responsible for this Page.",
"showVerifiedBadge": true,
"CONFIRMED_OWNER_LABEL": "NATIONAL GEOGRAPHIC PARTNERS, LLC"
}
]
}Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.