Facebook Marketplace API

Endpoints

Quick start

Coverage & limits

• Independent stateless worker on port 3039. No database, Facebook account, persistent browser session, cache or media hosting. Marketplace reads use plain HTTPS documents; a browser is the fallback for location search, keyword search and item details. A residential proxy can be configured for public pages that gate direct connections.
• Two concurrent requests, 60-second overall deadline, 400 upstream requests and 64 MiB decoded source bytes per request, shared by enrichment legs. Fresh browser contexts close after each retrieval.
• At most 100 records per page, 500,000 traversed nodes and depth 100. Full reels accept at most 50 records across five pages. Auxiliary reads have shorter deadlines and preserve usable partial data.
• A category list returns one tree level, at most 1,000 categories. Category browsing and keyword search return at most 100 listings per page with a caller-carried cursor.
• Only fixed Facebook public pages, native read-only GraphQL documents, Facebook static scripts and explicitly discovered fbcdn caption URLs are fetched. Service credentials never enter the browser. Media files are not downloaded.
• cache_max_age and hostMedia are not accepted. Opaque cursors are route-specific; pass back the cursor issued by the route you called.
• Facebook source changes, regional restrictions and private resources produce explicit failures. Missing counts remain null, never fabricated zeroes.