Facebook Marketplace Scraper — Listings, Prices, Vehicles & Monitoring

Disclaimer: Unofficial integration for publicly accessible Facebook Marketplace pages. Facebook, Meta, and Marketplace are trademarks of Meta Platforms, Inc. Not affiliated with, sponsored by, or endorsed by Meta. Provided for informational and research purposes only. You are solely responsible for complying with applicable laws and platform terms.

Scrape Facebook Marketplace listings by keyword or search URL — no login required. Export title, price, location, photos, vehicle specs (make, model, mileage, transmission), listing status, and date listed as clean JSON or CSV. Built for resale arbitrage, used-car research, price monitoring, lead alerts, and marketplace data pipelines.

Privacy-safe by default — seller identity, precise coordinates, VIN, and contact info in descriptions are stripped or redacted before export.

Crawloop Marketplace Suite — classifieds and marketplace scrapers for local listings intelligence.

Facebook Marketplace Scraper ◄── you are here	Kleinanzeigen Scraper	Marktplaats Scraper	Mobile.de Scraper
US Marketplace keyword & URL search	Germany classifieds & PLZ radius	Netherlands classifieds	Germany vehicle listings

---

Key Features

• Keyword search — pass searchQuery + marketplaceLocation; the Actor builds the Marketplace search URL
• Batch keywords — searchQueries array for larger pulls with automatic deduplication
• Direct URLs — scrape Marketplace search pages or individual item URLs via startUrls
• Vehicle data — structured vehicle object: make, model, odometer, transmission, fuel type when exposed by the listing
• Fast HTTP scraping — curl_cffi Chrome TLS impersonation; no headless browser overhead
• Dynamic GraphQL doc_id harvester — refreshes internal query IDs from Facebook JS bundles on session warmup
• Monitoring mode — emit only new listings since the previous run (Key-Value store deduplication)
• Privacy-safe output — privacySafeMode on by default: no seller profile, no lat/lng, no VIN, PII redacted in descriptions
• Optional detail enrichment — includeSeller visits each item page for full description and photo gallery
• eBay arbitrage add-on — compareWithEbay attaches sold-price margin metrics per unique keyword
• Residential proxy ready — geo-targeted Apify RESIDENTIAL proxy for stable US Marketplace access

---

When to use this Actor

• Resale & arbitrage — track underpriced listings, compare ask prices, monitor new inventory
• Used-car research — extract make, model, mileage, and price for vehicles, trucks, and RVs
• Price monitoring — scheduled runs with monitoringMode for new-listing alerts
• Market research — bulk JSON/CSV export by city, category, price band, and condition filters
• Data pipelines — feed datasets into dashboards, databases, and automation workflows

When not to use this Actor

• Seller contact or messaging — reads public listing data only; no Messenger or profile scraping
• Private groups or non-Marketplace pages — Marketplace search and item URLs only
• Guaranteed seller identity — guest sessions hide seller names; optional cookies may expose more, but privacy mode strips seller output by default
• Unlimited deep pagination without cookies — guest sessions may cap results per query; use batch keywords or authenticated cookies for larger pulls

---

Quick Start

Basic — keyword search in Phoenix:

{
  "searchQuery": "used trucks",
  "marketplaceLocation": "phoenix",
  "maxItems": 50,
  "privacySafeMode": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Large pull — multiple keywords:

{
  "searchQuery": "used",
  "searchQueries": ["furniture", "electronics", "tools", "car"],
  "marketplaceLocation": "phoenix",
  "maxItems": 150,
  "sortBy": "creation_time_descend",
  "privacySafeMode": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

---

Input Parameters

Parameter	Type	Default	Description
searchQuery	String	—	Primary keyword (e.g. used trucks, iphone)
searchQueries	Array	—	Extra keywords; deduplicated across the run
startUrls	Array	—	Marketplace search or item URLs
marketplaceLocation	String	phoenix	City slug (phoenix, nyc, la, chicago, …)
radiusKm	Integer	65	Search radius in kilometers
minPrice / maxPrice	Integer	—	Price filters in local currency
daysSinceListed	String	—	1, 7, or 30 (last 24h / 7d / 30d)
itemCondition	String	—	new,used_like_new,used_good,used_fair
categoryId	String	—	Category slug (vehicles, electronics, free, …)
sortBy	String	best_match	creation_time_descend, distance_ascend, price_ascend, price_descend
maxItems	Integer	50	Maximum listings to collect per run
includeSeller	Boolean	false	Fetch detail page for description, photos, attributes
flattenOutput	Boolean	false	Flatten nested objects for spreadsheet export
monitoringMode	Boolean	false	Only new listings vs previous runs
compareWithEbay	Boolean	false	Attach eBay sold-price arbitrage metrics
privacySafeMode	Boolean	true	Strip seller data, redact PII, remove coordinates & VIN
cookies	Array	[]	Optional session cookies for deeper pagination
proxyConfiguration	Object	Residential	Apify Proxy — required on cloud runs

---

Output Format

Each dataset row is one Marketplace listing.

Field	Type	Description
listingId	String	Unique Marketplace listing ID
listingTitle	String	Listing title
description	String	Full description when includeSeller is enabled
price	Object	formatted, value, currency
location	Object	city, state, text (coordinates removed in privacy mode)
listingPhotos	Array	Photo URLs
listingUrl	String	Direct item page URL
status	String	live, pending, or sold
dateListed	String	ISO 8601 creation date when available
vehicle	Object	Make, model, odometer, transmission (vehicles only)
ebayArbitrage	Object	Sold-price margin metrics when compareWithEbay is on
searchQuery	String	Keyword that produced this listing
scrapedAt	String	UTC scrape timestamp

Output Example

{
  "listingId": "1656134792124906",
  "listingTitle": "2009 Nissan Altima · 2.5 S Sedan 4D",
  "price": {
    "formatted": "$5,900",
    "value": 5900,
    "currency": "USD"
  },
  "location": {
    "text": "Phoenix, Arizona",
    "city": "Phoenix",
    "state": "AZ"
  },
  "listingPhotos": ["…"],
  "status": "live",
  "vehicle": {
    "make": "Nissan",
    "model": "Altima",
    "odometer": "85K miles"
  },
  "searchQuery": "used",
  "scrapedAt": "2026-07-15T11:30:06+00:00"
}

---

Supported Locations

Pre-mapped US city slugs include phoenix, nyc, la, sanfrancisco, chicago, austin, boston, seattle, atlanta, miami, portland, denver, dallas, houston, philadelphia, and lasvegas. Pass any Marketplace city slug via marketplaceLocation or embed it in startUrls.

---

Privacy & Personal Data

privacySafeMode is enabled by default. The Actor scrapes public listing pages but the saved dataset excludes sensitive fields:

• Seller name, profile ID, and profile URL are never written to the dataset
• Emails, phone numbers, and messenger links in descriptions are redacted
• Precise latitude and longitude are removed (city and state remain)
• Vehicle VIN is removed

Session cookies are used only for HTTP requests and are never stored in output.

Set privacySafeMode: false only if you have a documented lawful basis to collect seller identity, coordinates, or VIN.

---

FAQ

Do I need a Facebook account?

No. The Actor runs in guest mode by default. Optional cookies can improve pagination depth; seller data is still excluded when privacy mode is on.

How do I scrape only new listings?

Enable monitoringMode and run on a schedule. Listing IDs from previous runs are stored in the Key-Value Store; only new IDs are emitted.

How do I get vehicle make, model, and mileage?

Vehicle listings include a vehicle sub-object when Facebook exposes the data. Enable includeSeller for the fullest attribute set from the detail page.

How do I collect more than one page of results?

Use searchQueries with multiple keywords, increase maxItems, or provide authenticated cookies. Residential proxies matched to the target country are required on Apify Cloud.

Does this Actor collect seller names or phone numbers?

Not by default. Privacy-safe mode strips seller fields and redacts contact patterns in descriptions.

---

Limitations

• Facebook rotates internal GraphQL query IDs; the Actor harvests them dynamically with fallback values
• Guest sessions may return fewer listings per query than authenticated sessions
• Automating Marketplace may conflict with Meta platform terms — use responsibly and lawfully
• Datacenter proxies are often blocked; residential proxies geo-matched to the target region are required on cloud

---

Crawloop Marketplace Suite