InsightSocial API29 Facebook endpoints on one API key.
Pages and profiles, posts, comments, groups, reels, photos, events, Marketplace, search and the Meta Ad Library.
Base path: /v1/facebook/...
Quickstart
curl "https://api.insightsocial.app/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FMeta" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
9 of these are metered: the price depends on how much the call reads. See Credits.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/profile | 20 | Returns a Facebook page's public profile: page id, display name, profile image, bio, follower count, and page-like count. | url |
/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. | url, pageId |
/post | 20 | Returns one Facebook post in full: the post text, like, comment and share counts, a reactions breakdown, media attachments, and author info. | url |
/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. | url, feedback_id |
/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. | url, group_id |
/group | 20 | Returns a Facebook group's public record: name, description, member count, privacy, visibility, and creation date. | url, group_id |
/post/transcript | 200 | Returns the spoken words of a Facebook video post as a transcript, using Facebook's auto-generated captions. | url |
/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. | url |
/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. | url |
/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. | id, url |
/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. | pageId, companyName |
/adlibrary/search/ads | 100 | Returns Facebook Ad Library ads matching a keyword, each with its creative text, images, sponsor info, and running status. | query |
/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. | query |
/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. | url |
/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. | feedback_id, expansion_token |
/marketplace/location/search | 20 | Returns Facebook Marketplace locations and cities matching a search term, each with its lat and lng coordinates. | query |
/marketplace/search | 20 | Returns Facebook Marketplace listings near a lat/lng, each with title, price, location, photo, delivery types, and sold or live flags. | query, lat, lng |
/marketplace/item | 20 | Returns one Facebook Marketplace listing: title, description, price, location, condition, photos, seller, and availability flags. | id, url |
/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. | query |
/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. | url |
/event/details | 20 | Returns one Facebook event in full: title, description, start and end time, location, host, cover image, and RSVP counts when shown. | id, url |
/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. | id, url |
/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. | url |
/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. | url |
/search/posts | 20–180 | Returns public Facebook posts matching a keyword, each with text, permalink, publish time, like count, comment count, and author. | query |
/search/pages | 20 | Returns Facebook pages matching a keyword, each with page id, display name, permalink, avatar, and verified flag. | query |
/search/people | 20 | Returns Facebook people matching a keyword, each with profile id, display name, permalink, avatar, and verified flag. | query |
/search/videos | 20 | Returns public Facebook videos matching a keyword, each with video id, caption, permalink, thumbnail, and author. | query |
/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. | query |