Facebook scraper API
Public Facebook pages, posts, comments, groups, reels, events and Marketplace as JSON, plus the Meta Ad Library. No Page Public Content Access review.
29 endpoints · from 20 credits a call · 10 free calls · no credit card
curl "https://api.insightsocial.app/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FMeta" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Facebook data can you get?
Public Facebook data only, returned in the same JSON envelope as every other platform.
Pages and profiles
Name, bio, followers and page likes, and for businesses the address, rating and opening hours where the page lists them.
Posts, reels and comments
A page's posts and reels with reactions, comments and shares, and the full comment thread under any public post.
Groups, events and Marketplace
Posts in public groups, events by page or search, and Marketplace listings by keyword and location.
Meta Ad Library
Ads a company is running, ad search by keyword, and the spoken text of video ads.
Facebook API endpoints
All 29 Facebook endpoints and their price in credits. 9 are metered: they show a range and charge what the call actually read.
| Endpoint | Credits | What it returns |
|---|---|---|
| /profile | 20 | Returns a Facebook page's public profile: page id, display name, profile image, bio, follower count, and page-like count. |
| /profile/posts | 20–80 | Returns recent posts from a Facebook page or profile, each with the post text, like and comment counts, the per-reaction breakdown, media, and publish time. |
| /post | 20 | Returns one Facebook post in full: the post text, like, comment and share counts, a reactions breakdown, media attachments, and author info. |
| /post/comments | 20–100 | Returns comments on a Facebook post, each with the commenter's name, comment text, like count, reply count, and creation time. |
| /group/posts | 20 | Returns posts from a Facebook group, 3 to 4 per page, each with the post text, reaction count, comment count, the per-reaction breakdown, and author info. |
| /group | 20 | Returns a Facebook group's public record: name, description, member count, privacy, visibility, and creation date. |
| /post/transcript | 200 | Returns the spoken words of a Facebook video post as a transcript, using Facebook's auto-generated captions. |
| /profile/photos | 20–180 | Returns a page or profile's photos, each with a photo id, permalink, full-size image URL, thumbnail, and accessibility caption when available. |
| /profile/reels | 20 | Returns a page or profile's reels, each with a reel id, description, thumbnail, permalink, publish time, and a rounded public view count. |
| /adlibrary/ad | 100 | Returns one ad from the Facebook Ad Library: creative, CTA and link, run dates, display format, and the advertiser's page URL, likes and categories. |
| /adlibrary/company/ads | 100 | Returns the ads one company or page is running in the Facebook Ad Library, each with its creative, status, spend, and targeting info. |
| /adlibrary/search/ads | 100 | Returns Facebook Ad Library ads matching a keyword, each with its creative text, images, sponsor info, and running status. |
| /adlibrary/search/companies | 100 | Returns advertiser pages in the Facebook Ad Library matching a name, each with its page id, name, handle, verification badge and follower count. |
| /profile/events | 20–180 | Returns a Facebook page's upcoming and past events, each with a title, link, the start time, the venue, the city, the rendered time line, and the cancelled, past and online flags. |
| /post/comment/replies | 20–100 | Returns the replies under a single Facebook comment, each with the author name, reply text, like count, and creation time. |
| /marketplace/location/search | 20 | Returns Facebook Marketplace locations and cities matching a search term, each with its lat and lng coordinates. |
| /marketplace/search | 20 | Returns Facebook Marketplace listings near a lat/lng, each with title, price, location, photo, delivery types, and sold or live flags. |
| /marketplace/item | 20 | Returns one Facebook Marketplace listing: title, description, price, location, condition, photos, seller, and availability flags. |
| /events/search | 20 | Returns public Facebook events matching a keyword, each with name, date sentence, venue, cover photo, interested and going counts, and online and past flags. |
| /events | 20–260 | Returns the events listed on a Facebook city or region events page, each with a title, link, cover image, the start time, the venue, and the going and interested counts. |
| /event/details | 20 | Returns one Facebook event in full: title, description, start and end time, location, host, cover image, and RSVP counts when shown. |
| /adlibrary/ad/transcript | 200 | Returns the spoken words of a Facebook Ad Library video ad, from Facebook's captions when available or transcribed from the video itself. |
| /profile/full | 100 | Returns a page's profile plus its latest 3 posts and computed figures: engagement rate by views and by followers, posting cadence, top post, and format mix. |
| /profile/reels/full | 100–500 | Returns a page's reels with exact per-reel engagement merged in: views, likes, comments, and shares, plus each reel's id, thumbnail, and link. |
| /search/posts | 20–180 | Returns public Facebook posts matching a keyword, each with text, permalink, publish time, like count, comment count, and author. |
| /search/pages | 20 | Returns Facebook pages matching a keyword, each with page id, display name, permalink, avatar, and verified flag. |
| /search/people | 20 | Returns Facebook people matching a keyword, each with profile id, display name, permalink, avatar, and verified flag. |
| /search/videos | 20 | Returns public Facebook videos matching a keyword, each with video id, caption, permalink, thumbnail, and author. |
| /search/groups | 20–300 | Returns public Facebook groups matching your keywords, one row per group, with the group's name, id and URL in the same shape the group endpoints take. |
Parameters, response fields and examples for each endpoint are in the Facebook API reference.
InsightSocial vs the official Facebook API
The Facebook Graph API reads pages you manage. Public page content needs the Page Public Content Access feature and app review, and Meta retired the Groups API in 2024.
| InsightSocial API | Official Facebook API | |
|---|---|---|
| Public pages | Any public page | Page Public Content Access, after app review |
| Groups | Posts in public groups | Groups API retired in 2024 |
| Marketplace | Listings by keyword and location | Not offered |
| Approval | None. Sign in and copy a key | Meta app review and business verification |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Facebook API cost?
Facebook calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats are free
Call the same thing again inside its window, 1 to 24 hours depending on the endpoint, and it costs 0.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
The free Facebook scraper for Chrome exports the same data to Excel, CSV or Google Sheets from your browser, on the same account.
Facebook API: frequently asked questions
Yes, for public groups. /v1/facebook/group/posts returns a group's posts page by page. Meta removed its own Groups API in 2024, so there is no official route. Private groups need a member's session: the InsightSocial Chrome extension reads them from your own logged-in browser.
Meta's official Ad Library API is mainly for political and social-issue ads. /v1/facebook/adlibrary/search/ads and /v1/facebook/adlibrary/company/ads return any ad shown in the public Ad Library, with spend and reach where Meta publishes them.
Yes. /v1/facebook/marketplace/search finds listings by keyword near a location, and /v1/facebook/marketplace/item returns one listing in full. Use /v1/facebook/marketplace/location/search to turn a city name into a location.
A page profile is 20 credits. Posts, comments and search are metered: each quotes a range and charges what the call read. Calls that fail or return nothing are free.
No. There is no Facebook app, OAuth flow or review. One API key in the x-api-key header works for Facebook and the other 8 platforms.
Yes. Your first 10 calls priced at 200 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.