+Facebook API
Public Facebook pages, posts, comments, groups, Marketplace listings, events and search as JSON, with no Meta developer app.
The API.SH Facebook API returns public Facebook as JSON. Pages and public profiles come with category, followers, contact details, hours, rating and verified flag; the About tab, transparency panel (creation date, ad status, owner), reviews, followers, following, posts, photos, albums, videos, short videos and events each have a route. A post, photo, video or reel returns text, owner, time, reactions by type, comments, shares and views, with comment threads, reacting profiles and speech-to-text transcripts. Public groups return member counts, activity, admins, rules and their feed. Marketplace search filters by location, price, radius, condition, delivery and days since listed, and opens full listings. Search also covers pages, people, places, posts with date ranges, videos and events, and any Facebook link resolves to its type and id.
- 37 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/facebook/v1/ page
{"name": "NASA - National Aeronautics and Space Administration","url": "https://www.facebook.com/NASA/","page_id": "54971236771","category": "Government organization","intro": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨","followers": "28M","likes": null,"talking_about": 81128,"were_here": null,"phone": null,"email": "name@example.com","website": "nasa.gov/nasa-app","address": null,"recommend_percent": null,"review_count": null,"confirmed_owner": true,"profile_picture": "https://scontent.fgig14-2.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s72…","cover_photo": "https://scontent.fgig14-2.fna.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_tt6&cstp=mx2047x1487&…","social_links": [],"description": "NASA - National Aeronautics and Space Administration. 28,732,125 followers · 81,128 talking about this. Explore the universe and discover ou…","title": "NASA - National Aeronautics and Space Administration","intro_cards": {"INTRO_CARD_PROFILE_EMAIL": "name@example.com","INTRO_CARD_WEBSITE": "nasa.gov/nasa-app","INTRO_CARD_CONFIRMED_OWNER_LABEL": "NATIONAL AERONAUTICS AND SPACE ADMINISTRATION","INTRO_CARD_INFLUENCER_CATEGORY": "Page · Government organization"},"user_id": "100044561550831","followers_count": 28732125,"following": "52","following_count": 52,"likes_text": null,"social_context": [{"text": "28M followers","url": "https://www.facebook.com/NASA/followers/"},{"text": "52 following","url": "https://www.facebook.com/NASA/following/"}],"verified": null,"profile_type": "PAGE","profile_picture_hd": "https://scontent.fgig14-2.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s20…","price_range": null,"business_hours": null,"influencer_category": "Page · Government organization","cached": false,"credits_used": 1} What you can build with the Facebook API
Social listening on public posts
/facebook/v1/search/posts finds public posts for a keyword with recent=true or start_date and end_date, returning text, author and reaction, comment and share counts. Follow up with /facebook/v1/post/comments and /facebook/v1/post/reactions for the discussion around each one.
Resale pricing from Marketplace
Query /facebook/v1/marketplace/search with q, location, min_price, max_price, radius_km and condition, then open each listing with /facebook/v1/marketplace/item for description, photos, seller, delivery options and coordinates. /facebook/v1/marketplace/location/search finds the place to search in.
Local business leads
/facebook/v1/search/places with a city location_id and price filter lists businesses; /facebook/v1/page/about adds phone, email, websites, address with map pin, hours, rating and review count, and /facebook/v1/page/reviews the recommendations themselves.
Page transparency checks
/facebook/v1/page/transparency returns a page's creation date, whether it is running ads and its confirmed owner, a quick brand-safety, fraud or newsroom check before you trust a page. /facebook/v1/resolve turns share links into ids first.
Group research
/facebook/v1/group/about gives exact members, new members in the last week, posts per day and month, admins and rules; /facebook/v1/group/posts reads the public feed sorted recent or top, for community managers and market researchers.
Event listings
/facebook/v1/events/search finds events by keyword with date=this_weekend or date_from and date_to, category and location_id, and /facebook/v1/event/details returns start and end, place, hosts, ticket link, and going and interested counts.
Facebook data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Facebook API endpoints and prices
Every Facebook endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Facebook events search /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook event search /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook Marketplace search /facebook/ | $1 · $2 PAYG 1 credit |
| Look up a place for Marketplace search /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook Marketplace search /facebook/ | $1 · $2 PAYG 1 credit |
| Search Facebook pages /facebook/ | $1 · $2 PAYG 1 credit |
| Search Facebook people /facebook/ | $1 · $2 PAYG 1 credit |
| Search Facebook places /facebook/ | $1 · $2 PAYG 1 credit |
| Search Facebook posts /facebook/ | $1 · $2 PAYG 1 credit |
| Search Facebook videos /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page About tab /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page followers /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page following /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page reviews /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page transparency /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page photo albums /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page events /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page photos /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page / profile posts /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page short videos /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook page videos /facebook/ | $1 · $2 PAYG 1 credit |
| Public Facebook group posts /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook hashtag posts /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook photo /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook post /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook post comments /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook post reactions /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook video transcript /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook reel /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook video /facebook/ | $1 · $2 PAYG 1 credit |
| Replies to a Facebook comment /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook event /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook group /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook group About tab /facebook/ | $1 · $2 PAYG 1 credit |
| Facebook Marketplace listing /facebook/ | $1 · $2 PAYG 1 credit |
| Resolve a Facebook URL /facebook/ | $1 · $2 PAYG 1 credit |
Call the Facebook API
Facebook page: GET https://api.api.sh/facebook/
curl "https://api.api.sh/facebook/v1/page?url=bbcnews" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/facebook/v1/page",
params={"url": "bbcnews"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/facebook/v1/page");
url.searchParams.set("url", "bbcnews");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/facebook/v1/page", "url", "bbcnews")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Facebook" and "Facebook page".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Facebook data
- Public data only: no Facebook login, cookies or account needed
- One key and one response shape for Facebook and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Facebook API
Meta's Graph API reads Facebook data only for Pages, groups and users that grant your app permission, and most permissions require Meta's app review and business verification; it offers no general public post search to developers. API.SH reads public pages, posts, groups, Marketplace and events without a Meta app.
The open-source facebook-scraper package and similar scripts broke as Facebook changed its pages, and Apify splits Facebook into separate actors for pages, posts, comments, groups and Marketplace, each billed per result. API.SH serves all of these on one key and one JSON shape.
Facebook API questions
What Facebook data can I get?+
Pages and profiles: page, About tab, transparency, reviews, followers, following, posts, photos, albums, videos, short videos and events. Content: posts, photos, videos, reels, comments, comment replies, reactions and video transcripts. Groups: group with feed, About tab and posts. Marketplace: search, listing and location lookup. Events: search and details. Search: pages, people, places, posts and videos. Plus /facebook/v1/resolve for any Facebook URL or share link.
How much does the Facebook API cost?+
Every Facebook endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free Facebook API?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /facebook/v1/comment/replies at 1 credit each.
Is there an official Facebook API?+
Yes, Meta's Graph API, with the Pages API and Marketing API built on it. It works through a Meta developer app with access tokens, returns data only for assets that grant your app permission, and most permissions pass app review. Calls are free, but it is not open for reading arbitrary public pages, groups or Marketplace; Meta's Content Library is limited to approved researchers.
Do I need a Facebook account?+
No. You never sign in. Private groups, private profiles and anything Facebook shows only to logged-in users are not returned, and some lists, like a page's followers, stop at the first entries Facebook shows publicly.
Do I need a Facebook access token?+
Not with API.SH: requests carry only your API.SH key in the x-api-key header. Access tokens belong to the Graph API, where they are created through a Meta app and tied to the permissions a user or page grants it.
Can I scrape Facebook Marketplace?+
/facebook/v1/marketplace/search returns the listings Facebook's public Marketplace search page shows for a query and city: title, price, location, image and link. Facebook serves one page of results logged out, so narrow it with min_price, max_price, radius_km, condition, delivery, days_since_listed and sort, then open each item with /facebook/v1/marketplace/item.
How do I get comments and reactions on a Facebook post?+
/facebook/v1/post/comments with the post url returns comments with text, author, reactions and reply count, plus next_cursor for more; replies come from /facebook/v1/comment/replies with the comment's replies_token. /facebook/v1/post/reactions gives totals by type and the first profiles Facebook lists, filterable with type.
How do I find a Facebook page ID?+
Pass any Facebook URL or short link (fb.me, fb.watch, facebook.com/share/...) to /facebook/v1/resolve to get its type, numeric id, canonical URL and name. /facebook/v1/page/transparency also returns the Page ID along with the page's creation date.
How do I get started?+
Sign up at api.sh, copy your key and read a page with /facebook/v1/page?url=bbcnews, or try /facebook/v1/marketplace/search?q=bike&location=sanfrancisco. Every Facebook parameter is listed at https://api.sh/docs. Use the JS or Python SDK, Google Sheets, Zapier, Make or n8n, or connect an assistant through https://api.sh/mcp.
Does the Facebook API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Facebook calls in parallel as you need and pay only for the calls that run. If Facebook itself slows down, the call returns 503 with a retry-after header and is not charged.