Scraper API for Facebook
The ScrapeBadger Facebook API turnsfacebook.com into a clean JSON feed:
Marketplace listings, global search across seven tabs, Page and profile
detail, Group metadata and feeds, post and comment threads, and the public
Ad Library.
All endpoints are
GET, live under https://scrapebadger.com/v1/facebook/*,
and authenticate with the X-API-Key header. Credits are charged per request
(see the table below) and reported on the X-Credits-Used response header.Facebook’s own Graph API exposes no Marketplace inventory at any price,
and reading Pages, Groups or posts through Graph requires an owned asset plus
an approved permission. This API needs none of that — no Meta developer app,
no App Review, no OAuth tokens.
Features
- Marketplace search — public keyword search by Facebook place, without a
Facebook account. Set
strict_filters=trueto enforce radius (km), age and price bounds locally;include_details=trueadds description, public photos and approximate coordinates. Continuations explore bounded price ranges with partial coverage. Sort all collected pages for newest-first monitoring. See verified search and daily monitoring. - Marketplace category browse — walk a whole vertical (
vehicles,propertyrentals,electronics,apparel, …) in one location, with the same price and sort filters. - Marketplace item detail — the full listing: description body, complete
photos[]gallery, vertical-specificattributes(vehicle make/model/ mileage, property beds/baths) and seller profile. - Search across seven tabs — one mixed
alltab pluspages,people,groups,posts,placesandevents. Every result carries atype, an id and a canonical URL you can hand straight to a detail endpoint. - Pages & profiles — name, category, verification, cover photo, follower / like counts, and the About tile (website, phone, email, address, rating), plus paginated timelines.
- Groups — privacy, member count, description, creation date, and the group feed with full post objects.
- Posts & comments — a single post by numeric id,
pfbidstring,permalink.phpform or reel URL, with attachments, reaction breakdown (top_reactions[]), share and comment counts — and the comment thread with author, reactions and reply counts. - Ad Library — competitive-intelligence search over Facebook’s public ad
archive: creative copy, snapshot URL, flight dates,
publisher_platforms[], images/videos and the CTA — plus advertiser Page search, Page transparency info (owner, admin countries, history, political ad spend) and EU DSA transparency (reach and demographics) on ad lookups with an EUcountry.
Markets
Marketplace is location-scoped by slug and the Ad Library is country-scoped by ISO code. Search, Pages, Groups and posts are global and need no market parameter.Credits
Quickstart
Pagination
Every list endpoint uses Facebook’s Relay cursor pagination — there are no page numbers. Readend_cursor from the response and pass it back as the
after query parameter while has_next_page is true.
Python
Timestamps
Every datetime ships in both forms:*_utc (Unix seconds, e.g.
creation_time_utc) and *_at (ISO 8601 UTC string, e.g. created_at).
Run this asynchronously
Calls on this API can run in the background, so you don’t hold a connection open while they work. Add one of these to the call:ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by Facebook or Meta. “Facebook” is a trademark of Meta Platforms, Inc., used here only to describe the platform this scraper is designed to work with.

