Facebook data API for AI agents: public pages, groups, ads and Marketplace
The public Facebook data Meta's Graph API won't give you: pages and groups you don't manage, the ads any advertiser is running, and Marketplace listings, as data your agent reads in Claude, ChatGPT or Codex. No Facebook app, no App Review and no page token.
Read-only. These tools read public Facebook pages, groups, posts, ads and Marketplace listings. They never post, comment, like, follow or send a message, and they never sign in to an account of yours: there is no login, cookie or browser extension of yours anywhere in the call.
updated Nov 3, 2026
Copy the setup prompt.
Your agent does the rest.
Connect the superagnt MCP server at https://mcp.superagnt.com/mcp/facebook to this agent for me (I'll sign in through my browser). The setup guide for each kind of agent is at https://www.superagnt.com/install?facet=facebook» a new workspace starts with the Facebook tools already on. On an existing workspace, your agent switches them on during setup.
What can't Meta's own APIs read, and which Facebook tool do you need?
Meta's APIs are built for things you own: the Pages API needs a page token and a role on the page, the Groups API was removed in April 2024, Marketplace has no API to read listings, and the Ad Library API returns ads outside the EU only when they are about social issues, elections or politics. Meta's ads MCP server runs your own ad account. To read what everyone else is doing, use this source.
| Job | superagnt | Meta (official) |
|---|---|---|
| Read a page you don't manage | Yes: details, posts, videos, reels | Needs a page token and a role, or an App Review feature |
| Read group posts | Yes, public groups | No: the Groups API was removed on April 22, 2024 |
| See any advertiser's ads | Yes, by keyword and country (in the US: Taco Bell, Target) | Only social issue, election and political ads, plus ads delivered in the EU |
| Search Marketplace listings | Yes, by place and price band | No read API: only approved partners upload listings |
| Run your own ads | Not offered: read-only | Yes: the Marketing API, or Meta's ads MCP server (open beta since April 2026) |
| What you need | One key, over MCP or HTTP | A Meta app, App Review and tokens |
What can your agent read from Facebook?
Page details from a link, page posts, videos and reels, with follower counts and verification.
Group details, posts and videos, from a group link or id.
Post detail, attachments, comments and replies, and keyword search across posts, pages, people, videos and places.
Search advertisers by keyword and country, pull the ads a page is running, and fetch one ad's detail, for any advertiser.
Search listings, vehicles and rentals by place and price band, plus categories, city coordinates and seller detail.
data_facebook_postsaction: details · post_id · attachments · video_details · comments · comment_replies · download_mediadata_facebook_adsaction: search_pages · search_keywords · page_ads · ad_details · supported_countriesdata_facebook_searchaction: posts · people · pages · videos · locationsdata_facebook_groupsaction: group_id · details · metadata · posts · videosdata_facebook_marketplaceaction: search · vehicles · rentals · listing · seller · categories · city_coordinatesdata_facebook_pagesaction: details · page_id · posts · reels · videos
per-operation names35older servers list these
data_facebook_get_facebook_video_post_detailsdata_facebook_get_facebook_posts_commentsdata_facebook_get_facebook_post_detailsdata_facebook_get_facebook_post_attachement_detailsdata_facebook_get_facebook_posts_comment_repliesdata_facebook_fetch_archive_ad_detailsdata_facebook_fetch_page_ad_detailsdata_facebook_fetch_search_ads_pages_getdata_facebook_fetch_search_ads_pages_postdata_facebook_download_mediadata_facebook_fetch_search_videosdata_facebook_get_group_videosdata_facebook_get_marketplace_listing_item_detailsdata_facebook_get_facebook_groups_postsdata_facebook_get_facebook_group_detailsdata_facebook_get_page_reelsdata_facebook_get_page_videosdata_facebook_get_facebook_pages_postsdata_facebook_get_facebook_page_detailsdata_facebook_get_marketplace_rental_property_search_resultsdata_facebook_get_marketplace_city_coordinatesdata_facebook_get_marketplace_vehicles_search_resultsdata_facebook_get_marketplace_categoriesdata_facebook_fetch_search_postsdata_facebook_get_marketplace_search_resultsdata_facebook_get_facebook_group_iddata_facebook_get_facebook_group_metadata_detailsdata_facebook_get_seller_detailsdata_facebook_get_supported_countriesdata_facebook_fech_search_ads_keywordsdata_facebook_fetch_search_locationsdata_facebook_fetch_search_peopledata_facebook_fetch_search_pagesdata_facebook_get_facebook_post_iddata_facebook_get_facebook_page_idWhat does a real call return?
A run we recorded on superagnt, with the result trimmed to fit. Nothing on it is invented: the date, the wall time and the cost are the run's own.
asked Which brands are running cold brew ads in the US right now?
- → call
data_facebook_ads{ "action": "search_pages", "query": "cold brew coffee", "country": "US", "response_limit": 5 }← resulttrimmed| page_name | body | cta | is_active | start_date | | Happy Products | more than just coffee | Learn more | false | 2025-10-20 | | Taco Bell | life is full of possibilities. also the purple horchata… | Order now | true | 2026-10-15 | | Target | Ready, set, fall! Discover Pumpkin Cream Cold Brew… | Shop now | true | 2026-08-24 | | Tropical Smoothie Cafe | Fave smoothie cup = fave coffee mug. Try the new… | Order now | true | 2026-09-15 | 5 of 9 ads on this page
the same call over httpcurl · python
curl "https://api.superagnt.com/v1/data/facebook/fetch_search_ads_pages?query=cold%20brew%20coffee&country=US" \
-H "Authorization: Bearer $SUPERAGNT_API_KEY"import os, requests
r = requests.get(
"https://api.superagnt.com/v1/data/facebook/fetch_search_ads_pages",
params={"query": "cold brew coffee", "country": "US"},
headers={"Authorization": f"Bearer {os.environ['SUPERAGNT_API_KEY']}"},
)
print(r.json())» Each ad also comes back with its archive id, link and the platforms it runs on (Facebook, Instagram, Messenger, Threads).
Is there an API for the Facebook Ad Library?
Meta's Ad Library API exists, but outside the EU it returns only ads about social issues, elections or politics, and since October 2025 Meta runs no political ads in the EU at all. The search above returned ordinary commercial ads running in the US, active or not, with their copy, call to action, link, start date and platforms, so an agent can watch a competitor's creative without being the advertiser.
checked Nov 3, 2026 · Ad Library tools (Meta Transparency Center); Ads Archive API reference (Meta)
What do people use it for?
Competitor ad monitoring
A schedule searches the ad library for the advertisers in your category each week, pulls the creatives each page is running, and reports what is new and what was dropped.
Group lead sourcing
The agent reads posts in the public groups your buyers live in, keeps the ones with intent language, and writes them with author and link to the workspace database.
Marketplace price tracking
For a category and radius, the agent pulls listings on a cadence, tracks asking price and time on market, and flags anything below the band you set.
What does it cost?
Every call in this source costs the same.
About 357 calls.
Only a call that returns data is billed: a miss, a refusal or an upstream failure costs nothing. One credit balance covers this source and every other one, so there is no per-source subscription and no upstream account of yours to keep alive. After the trial, plans are Starter $49 a month ($20 of data credit included), Growth $149 a month ($90) and Scale $399 a month ($300). Requests per minute: Starter 60, Growth 300 and Scale 600.
What do people ask before they wire it up?
01Is there an API for the Facebook Ad Library?
Meta's Ad Library API covers ads about social issues, elections or politics, plus ads delivered in the EU. To see any advertiser's commercial ads elsewhere, use a source like this one: our search for cold brew ads in the US returned Taco Bell, Target and Tropical Smoothie Cafe ads.
02Can I get Facebook group posts through an API?
Not from Meta: the Groups API was removed on April 22, 2024. This source reads the details, posts and videos of public groups from a group link or id.
03Is there a Facebook Marketplace API?
Meta's only Marketplace program lets approved partners upload listings; there is no API to read or search them. This source searches listings, vehicles and rentals by place and price band.
04Do I need a Facebook app or App Review?
Not here: there is no app to submit, no permission review and no page token. Meta's own APIs need all three for most public page data.
05Which Facebook MCP server do I need?
Meta's ads MCP server, in open beta since April 2026, manages your own ad account. This one reads the public side: other pages, groups, everyone's ads and Marketplace. Many teams use both.