Platforms/Facebook
Facebook API
Read public Facebook profiles and Pages with their posts, reels, photos and events, a post's comments and replies, public groups, events, Marketplace listings, Meta's Ad Library, and event and video search, as JSON. Every call reads what a logged-out visitor sees: no Facebook account and no developer app.
Facebook endpoints
21 endpoints, each a GET request with your key in the x-api-key header.
| Endpoint | Request | Returns |
|---|---|---|
| Profile | GET /v1/facebook/profile?handle=uniladmag | A profile or Page: its name, category, bio, followers, picture and cover, and the details its Intro shows logged out, such as a Page's address, phone, email, website, hours and rating. |
| Profile posts | GET /v1/facebook/profiles/posts?handle=uniladmag | A profile's or Page's posts, newest first, 3 a page: as many as Facebook shows logged out. |
| Profile reels | GET /v1/facebook/profiles/reels?handle=uniladmag | A profile's or Page's reels, newest first, 10 a page, with their plays (rounded) and video files. |
| Profile photos | GET /v1/facebook/profiles/photos?handle=uniladmag | A profile's or Page's photos, newest first, 8 a page. |
| Profile events | GET /v1/facebook/profiles/events?handle=brickyardoldtown | A Page's upcoming events, 8 a page. |
| Post | GET /v1/facebook/posts?url=https%3A%2F%2Fwww.facebook.com%2Funiladmag%2Fposts%2Fpfbid02h8QyMzZrMtHks9iU7oneNe4yTKMzNPynvA9WYMedK7eLjU422HD6u3dfmvmgT5QQl | A post, reel or video: its text, author, time, reactions, comments, shares and views, and its photo or video. |
| Post comments | GET /v1/facebook/posts/comments?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F2696287970785751 | A post's, reel's or video's comments, 10 a page. |
| Comment replies | GET /v1/facebook/posts/comments/replies?post_id=1822818806556447&comment_id=978478641913739 | A comment's replies, oldest first, about 10 a page. |
| Group | GET /v1/facebook/groups?group_id=366190054572553 | A group: its name, description, privacy, members and history, as its About page shows them logged out. |
| Group posts | GET /v1/facebook/groups/posts?group_id=366190054572553 | A public group's posts, 3 a page. |
| Event | GET /v1/facebook/events/details?event_id=2219404332228026 | A public event: its name, time, place, host and description. |
| City events | GET /v1/facebook/events?city_id=111326725552547 | Upcoming public events in a city, 12 a page, as Facebook's events page for the city lists them. |
| Event search | GET /v1/facebook/events/search?query=dogs | Public events by name, as Facebook's logged-out event search finds them: 3 to 7 a page. |
| Video search | GET /v1/facebook/search/videos?query=dogs | Public videos and reels, as Facebook's logged-out video search finds them: about 5 a page. |
| Marketplace item | GET /v1/facebook/marketplace/items?item_id=1656586118821988 | A Marketplace listing: its title, price, description, condition, place, photos and seller. |
| Marketplace search | GET /v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475 | Marketplace listings near a place, as Facebook's logged-out Marketplace search finds them: the first 24. |
| Marketplace locations | GET /v1/facebook/marketplace/locations/search?query=Austin | Places by name, with the latitude and longitude the Marketplace search takes: up to 10. |
| Ad | GET /v1/facebook/ad-library/ads?ad_id=1255232986092838 | An ad in Meta's Ad Library: its advertiser, text, headline, link, image or video, platforms and dates. |
| Ad search | GET /v1/facebook/ad-library/ads/search?query=running | Ads in Meta's Ad Library by keyword, about 10 a page: by the country, status, media and dates given. |
| Company ads | GET /v1/facebook/ad-library/companies/ads?page_id=15087023444 | An advertiser's ads in Meta's Ad Library, about 10 a page. |
| Company search | GET /v1/facebook/ad-library/companies/search?query=nike | Advertisers in Meta's Ad Library by name, with the Page id the company ads endpoint takes: up to 15. |
Your first request
Save your key and the base URL, then call the profile endpoint:
export API_KEY="your-api-key"
export API_URL="https://api.socialparse.dev"
curl -H "x-api-key: $API_KEY" "$API_URL/v1/facebook/profile?handle=uniladmag"Every answer has the same envelope on every platform: data, page for the next page, and meta. See Responses and Errors.
Compared with Facebook's own API
Meta's Graph API reads public Pages only after App Review, for the apps it approves, and reads no public groups or Marketplace listings at all. Social Parse needs neither: it reads the public pages, and you pay per successful call.
Pricing
One credit per successful call, whichever endpoint; errors cost nothing and credits never expire. New accounts start with 100 free credits. See pricing for the packs.
FAQ
Do I need Facebook credentials or developer approval?
No. Social Parse reads Facebook's public pages as a logged-out visitor does, so you only need an API key.
What does each Facebook call cost?
One credit per successful call, live or cached; a page of results is one call, and errors cost nothing. New accounts get 100 free credits.
What about private Facebook content?
Only what a logged-out visitor can see is read. Content behind a login answers 403 LOGIN_REQUIRED, and something deleted answers 404 NOT_FOUND.
How fresh is the data?
Each call reads the live page. The same call within a few minutes is answered from a short cache, and deleted content is never served from it.