Facebook Marketplace Scraper

Scrape Facebook Marketplace search results, direct item details, and location lookups into clean structured records. This actor is perfect for SEO and AI agents, MCP optimized, and designed for product research, local-market monitoring, lead discovery, resale analysis, and price intelligence.

What it extracts

• Marketplace search listings by query and location
• Direct Marketplace item details by URL or listing ID
• Location lookup results with latitude and longitude
• Listing titles, IDs, URLs, prices, photos, status flags, delivery types, category IDs, and locations
• Item descriptions, created time, condition attributes, seller info when available, photos, shipping flags, and sold/live/pending status
• Provider pagination cursors for continuation runs

Input modes

Use searchQueries with either latitude and longitude, or a locationQuery such as Austin, TX. The actor resolves the location first, then searches Marketplace around those coordinates.

Use itemUrls or itemIds when you already know the listing and want item detail records.

Set includeItemDetails to true when you want each search listing enriched with a full item detail request. Leave it off for lower-cost bulk search.

Provider-backed reliability

Facebook Marketplace is heavily login-gated in browser sessions. This actor uses configured provider APIs first:

• SCRAPECREATORS_API_KEY
• SOCIAVAULT_API_KEY
• SOCIALVAULT_API_KEY as a backwards-compatible alias

Provider keys are owner secrets, never user input. If no provider key is configured, the actor exits successfully with a diagnostic OUTPUT summary instead of failing the run.

Example input

{
  "searchQueries": ["bike"],
  "locationQuery": "Austin, TX",
  "radiusKm": 40,
  "maxListings": 25,
  "maxPages": 2,
  "countPerPage": 24,
  "sortBy": "suggested",
  "availability": "in_stock"
}

Output

Dataset rows include recordType values:

• location
• listing
• item

The key-value store contains OUTPUT and RUN_SUMMARY with totals, provider status codes, dedupe counts, estimated PPE cost, and nextCursors.

Pricing

This actor uses pay per event:

• listing-scraped: $0.004 per listing row
• item-scraped: $0.006 per item detail row
• location-found: $0.001 per location lookup row

Pricing preserves provider cost margin while keeping bulk search predictable.