Facebook+API.SH

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
Facebook page
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}
1 credit · $1 per 1,000 calls

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.

Replies to a Facebook comment/facebook/v1/comment/replies
count10next_cursoreyJmIjoiWm1WbFpHSmhZMnM2Y0daaWFX…
replies[]id · text · created_at · author · reactions · reply_count · replies_token · attachments · graphql_id · url · depth · created_time
Facebook event/facebook/v1/event/details
id1474625497812411nameMAX POWERurlhttps://www.facebook.com/events/…start2026-11-07T13:30:00.000Zwhen7 Nov at 08:30 – 8 Nov at 18:00 …duration2 daysis_onlinefalsekindPUBLIC_TYPEfrequencySINGLEaddressRocket Garden, Nasa Pkwy W, Kenn…cityMerritt Island, FloridadescriptionAmerica’s newest and most exciti…ticketshttps://www.nasa.gov/maxpower/responded494coverhttps://scontent-arn2-1.xx.fbcdn…start_timestamp1794058200is_pastfalseis_canceledfalse
place[]id · name · latitude · longitude
creator[]id · name
hosts[]id · name · url · verified
Facebook events search/facebook/v1/events
queryNew York, NYcount3
events[]id · title · date · location · url · start_timestamp · is_online · is_past · social_context · price_range · cover · end_timestamp
available_filters[]name · label · current · values

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

Search and discovery10
Facebook events search
/facebook/v1/events
params q +7 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook event search
/facebook/v1/events/search
params q +7 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook Marketplace search
/facebook/v1/marketplace
params none required +11 optionaldocstry
$1 · $2 PAYG
1 credit
Look up a place for Marketplace search
/facebook/v1/marketplace/location/search
params qdocstry
$1 · $2 PAYG
1 credit
Facebook Marketplace search
/facebook/v1/marketplace/search
params none required +31 optionaldocstry
$1 · $2 PAYG
1 credit
Search Facebook pages
/facebook/v1/search/pages
params q +1 optionaldocstry
$1 · $2 PAYG
1 credit
Search Facebook people
/facebook/v1/search/people
params q +2 optionaldocstry
$1 · $2 PAYG
1 credit
Search Facebook places
/facebook/v1/search/places
params q +3 optionaldocstry
$1 · $2 PAYG
1 credit
Search Facebook posts
/facebook/v1/search/posts
params q +4 optionaldocstry
$1 · $2 PAYG
1 credit
Search Facebook videos
/facebook/v1/search/videos
params q +1 optionaldocstry
$1 · $2 PAYG
1 credit
Profiles and accounts12
Facebook page
/facebook/v1/page
params urldocstry
$1 · $2 PAYG
1 credit
Facebook page About tab
/facebook/v1/page/about
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook page followers
/facebook/v1/page/followers
params urldocstry
$1 · $2 PAYG
1 credit
Facebook page following
/facebook/v1/page/following
params urldocstry
$1 · $2 PAYG
1 credit
Facebook page reviews
/facebook/v1/page/reviews
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook page transparency
/facebook/v1/page/transparency
params urldocstry
$1 · $2 PAYG
1 credit
Facebook page photo albums
/facebook/v1/profile/albums
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook page events
/facebook/v1/profile/events
params urldocstry
$1 · $2 PAYG
1 credit
Facebook page photos
/facebook/v1/profile/photos
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook page / profile posts
/facebook/v1/profile/posts
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook page short videos
/facebook/v1/profile/reels
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook page videos
/facebook/v1/profile/videos
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Posts and media9
Public Facebook group posts
/facebook/v1/group/posts
params url +2 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook hashtag posts
/facebook/v1/hashtag
params tag +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook photo
/facebook/v1/photo
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook post
/facebook/v1/post
params urldocstry
$1 · $2 PAYG
1 credit
Facebook post comments
/facebook/v1/post/comments
params url +2 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook post reactions
/facebook/v1/post/reactions
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook video transcript
/facebook/v1/post/transcript
params urldocstry
$1 · $2 PAYG
1 credit
Facebook reel
/facebook/v1/reel
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook video
/facebook/v1/video
params url +1 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews1
Replies to a Facebook comment
/facebook/v1/comment/replies
params token +1 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places5
Facebook event
/facebook/v1/event/details
params urldocstry
$1 · $2 PAYG
1 credit
Facebook group
/facebook/v1/group
params url +2 optionaldocstry
$1 · $2 PAYG
1 credit
Facebook group About tab
/facebook/v1/group/about
params urldocstry
$1 · $2 PAYG
1 credit
Facebook Marketplace listing
/facebook/v1/marketplace/item
params urldocstry
$1 · $2 PAYG
1 credit
Resolve a Facebook URL
/facebook/v1/resolve
params urldocstry
$1 · $2 PAYG
1 credit

Call the Facebook API

Facebook page: GET https://api.api.sh/facebook/v1/page

curl "https://api.api.sh/facebook/v1/page?url=bbcnews" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More social APIs all social media APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key