Facebook API
Retrieve public Facebook Pages, posts, photos, videos, albums, and audience connections. Search Pages, people, places, posts, events, and videos, and browse Marketplace listings.
21 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Marketplace
2 endpoints- Get a Marketplace listing (v1)GETReturns a single Marketplace listing plus the related listings shown alongside it.
/v1/facebook/marketplace/item1 cr - List Marketplace listings (v1)GETReturns public Marketplace listings, optionally scoped to a category. Results are location-dependent: Facebook serves listings near the requester's location.
/v1/facebook/marketplace1 cr
Page
8 endpoints- Get a page (v1)GETReturns the public Page's id and any timeline posts included on the page. Use /facebook/page/posts to paginate the full feed.
/v1/facebook/page1 cr - Get page details (v1)GETReturns the Page's About field sections — category, contact info, websites and social links, plus business details (hours, price range, services, ratings) where the Page is a business.
/v1/facebook/page/about1 cr - Get page transparency data (v1)GETReturns Page Transparency fields — page id, creation date, admin country information, ad status and confirmed owner.
/v1/facebook/page/transparency1 cr - List page albums (v1)GETReturns the Page's photo albums. Pass cursor to page.
/v1/facebook/page/albums1 cr - List page followers or followed accounts (v1)GETReturns the Page's followers or following list with a total count. Pass cursor to page.
/v1/facebook/page/collection1 cr - List page posts (v1)GETReturns the Page's timeline posts. Pass cursor to page.
/v1/facebook/page/posts1 cr - List page reviews (v1)GETReturns a Page's public reviews with the reviewer, recommend or don't-recommend verdict, text, time and reaction and comment counts. Returns three reviews per request (Facebook's page size); pass cursor from pageInfo for more. A Page without a reviews tab returns an empty list.
/v1/facebook/page/reviews1 cr - List page videos (v1)GETReturns the Page's videos. Pass cursor to page.
/v1/facebook/page/videos1 cr
Post
4 endpoints- Get a photo (v1)GETReturns a public photo permalink with its initial comments and their pagination state.
/v1/facebook/photo1 cr - Get a post (v1)GETGet a public post and its initial comments. This operation returns the first comment page only; use /facebook/post/comments to page.
/v1/facebook/post1 cr - List comment replies (v1)GETReturns the replies to one comment, using feedbackId and expansionToken from the comments response. Pass cursor from pageInfo to page.
/v1/facebook/post/comments/replies1 cr - List post comments (v1)GETReturns a public post's comments with author, text, time, reaction and reply counts. Pass cursor from pageInfo to page. Use feedbackId and expansionToken from a comment to fetch its replies.
/v1/facebook/post/comments1 cr
Search
7 endpoints- Search events (v1)GETSearches public Facebook events by free text and returns each event's id, name, URL and cover image. Dates and venues are not shown without an account. Paginate with cursor from pageInfo. An empty events array means no public match.
/v1/facebook/search/events1 cr - Search Pages (v1)GETSearches public Facebook Pages by free text and returns each Page's id, name, URL, profile picture, verified flag and description. Paginate with cursor from pageInfo. An empty pages array means no public match.
/v1/facebook/search/pages1 cr - Search people (v1)GETSearches public Facebook profiles by name and returns each profile's id, name, URL and profile picture, plus a location line when shown. Paginate with cursor from pageInfo. An empty people array means no public match.
/v1/facebook/search/people1 cr - Search places (v1)GETSearches Facebook's public local businesses and places by free text and returns each place's id, name, URL, profile picture and description. Paginate with cursor from pageInfo. An empty places array means no public match.
/v1/facebook/search/places1 cr - Search public posts (v1)GETSearches public Facebook posts by free text and returns each post's text, author, creation time, photos and reaction, comment and share counts. Paginate with cursor from pageInfo. An empty posts array means no public match.
/v1/facebook/search/posts1 cr - Search top results (v1)GETSearches Facebook's top results for free text and returns a mixed list of posts and profiles. Each result has a type field naming its shape. Paginate with cursor from pageInfo. An empty results array means no public match.
/v1/facebook/search/top1 cr - Search videos (v1)GETSearches Facebook's public video catalogue by free text and returns matching videos with owner, duration and thumbnail. Paginate with cursor from pageInfo. An empty videos array means no public match.
/v1/facebook/search/videos1 cr
What you can build
- Build a directory of public business pages.
- Collect page posts for content research.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/facebook/search/events?query=<query>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.