Facebook Marketplace Scraper

Search Facebook Marketplace by keyword or URL — no login required — and export every listing as clean JSON or CSV: price, location, seller, all photos, GPS coordinates, and full structured vehicle data (make, model, mileage, transmission, VIN) for cars, trucks, RVs & boats.

Point it at a keyword, a search URL, or an individual item URL. Filter by price, condition, delivery method, date listed, and location radius. Run it once or in monitoring mode to capture only newly-listed items. Pure HTTP — no headless browser, no third-party CAPTCHA service.

Why Use This Scraper?

• 🚗 Full vehicle / car data — every vehicle listing returns a structured vehicle object: make, model, trim, odometer (mileage), transmission, fuel type, exterior & interior color, title status, number of owners, VIN, seller type, and a specifications block. Built for car dealers, flippers, and automotive market research.
• 🔎 Keyword search — no URL needed — pass a plain searchQuery ("used cars", "iphone", "sleeper trucks") and the actor builds the Marketplace search for you. Most scrapers force you to hand-build search URLs.
• 🔓 No Facebook login required — runs cookie-free by default. Cookies are an optional enhancement, not a requirement, so there's no account-ban risk to get started.
• 🎚️ Rich filters — price range, item condition (new / used-like-new / good / fair), delivery method, availability, days-since-listed, and exact-match toggle — all without touching a URL.
• 📍 Precise geo targeting — search any Marketplace location by name, or by latitude/longitude with a kilometre radius, plus precise-location filtering to keep results inside your target area.
• 🔁 Monitoring mode — run on a schedule and emit only new listings since the last run — ideal for price tracking, lead alerts, and inventory monitoring.
• 🖼️ All photos + GPS — full listingPhotos array (not just the thumbnail) and exact latitude/longitude, plus seller details when includeSeller is enabled.
• ⚡ Pure HTTP at scale — Cheerio + direct API calls, tunable concurrency and delays, JSON / CSV / Excel export.

Overview

The actor emits one flat record per Marketplace listing. Core fields (title, price, location, photos, seller, status flags, timestamps) sit at the top level. When a listing is a vehicle, a structured vehicle object is attached. Enable includeSeller to visit each item's detail page for the full description, all photos, attributes, and seller data; leave it off for faster, lighter search-only runs.

Supported Inputs

Input	Example	What you get
Keyword (searchQuery)	"used cars"	The actor builds the Marketplace search URL for you
Search URL (startUrls)	https://www.facebook.com/marketplace/nyc/search/?query=sleeper%20trucks	Every listing on that search (with paging)
Category URL	https://www.facebook.com/marketplace/tulsa/vehicles	Every listing in that category/location
Item URL (startUrls)	https://www.facebook.com/marketplace/item/3039750046185684/	Full detail for that single listing

Pure HTTP. No browser, no third-party CAPTCHA-bypass service. No Facebook login required.

Use Cases

Audience	What they use it for
Car dealers & flippers	Pull make/model/mileage/transmission/title status across a city to spot underpriced vehicles
Resellers & arbitrage	Track price drops and new listings for target products in monitoring mode
Market researchers	Price distributions, inventory volume, and category trends by region
Lead generation	Surface sellers and listings matching a niche, with location and contact context
Price intelligence	Compare asking prices across locations and over time

How It Works

1. You provide a keyword, search URL, category URL, or item URL — plus any filters (price, condition, location radius, date).
2. For keyword input, the actor constructs the correct Marketplace search URL, applying your filters and chosen location.
3. It fetches Marketplace's internal API directly over HTTP (Cheerio, no browser), paging through results up to maxItems.
4. With includeSeller enabled, each listing's detail page is fetched for the full description, all photos, attributes, seller data, and — for vehicles — the complete vehicle field set.
5. Each listing is normalized to a flat record (optionally fully flattened with flattenOutput) and pushed to your dataset as JSON / CSV / Excel.

Input Configuration

Field	Type	Notes
searchQuery	string	Keyword to search — the actor builds the search URL for you
startUrls	array	Marketplace search, category, or item URLs
sortBy	string	Sort order (e.g. newest first, price ascending/descending)
minPrice / maxPrice	number	Price range filter
conditionNew / conditionUsedLikeNew / conditionUsedGood / conditionUsedFair	boolean	Item-condition filters
availability	string	Available vs sold listings
deliveryMethod	string	Shipping vs local pickup
daysSinceListed	number	Only listings newer than N days
exact	boolean	Exact-match search
marketplaceLocation	string	Target Marketplace location by name
radiusKm	number	Search radius around the location
latitude / longitude	number	Precise coordinates to search around
preciseLocation	boolean	Keep results strictly inside the target area
locationResultsMode	string	How to handle out-of-radius results (maximize vs mark/exclude)
countryPreset	string	Country preset for the search
categoryId	string	Advanced: target a specific Marketplace category
includeSeller	boolean	Visit each item page for full details + seller + all photos + vehicle data
monitoringMode	boolean	Emit only newly-listed items vs previous runs
flattenOutput	boolean	Flatten nested objects for easier CSV/spreadsheet use
cookies	string	Optional Facebook cookies (not required; sanitized & reused if provided)
maxItems	number	Maximum listings per run
minDelay / maxDelay	number	Delay window between API calls
maxConcurrency / minConcurrency	number	Parallelism bounds
maxRequestRetries	number	Retry budget for failed requests
proxy	object	Proxy configuration (Apify Residential recommended)

Example input

{
  "searchQuery": "used cars",
  "marketplaceLocation": "tulsa",
  "radiusKm": 65,
  "minPrice": 5000,
  "maxPrice": 40000,
  "sortBy": "price_ascend",
  "includeSeller": true,
  "monitoringMode": false,
  "maxItems": 200,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }
}

Output Overview

Each record is a single Marketplace listing. Top-level fields cover the listing itself (title, price, location, photos, status, timestamps). A nested vehicle object is attached for cars, trucks, RVs, and boats. Enable includeSeller to also populate the full description, all photos, attributes, and seller object.

Output Sample

Trimmed real record for a vehicle listing (with includeSeller + flattenOutput):

{
  "facebookUrl": "https://www.facebook.com/marketplace/tulsa/vehicles",
  "id": "1181360107153349",
  "itemUrl": "https://www.facebook.com/marketplace/item/1181360107153349/",
  "listingTitle": "2026 Chevrolet Blazer EV SS",
  "listingPrice": { "amount": "44990", "currency": "USD", "formatted_amount": "$44,990" },
  "location": { "reverse_geocode": { "city": "Tulsa", "state": "US-OK" } },
  "locationText": "Tulsa, OK",
  "latitude": 36.1539,
  "longitude": -95.9928,
  "listingPhotos": [ { "image": { "uri": "https://scontent.xx.fbcdn.net/...jpg", "width": 960, "height": 960 } } ],
  "seller": { "name": "…", "id": "…" },
  "deliveryTypes": ["IN_PERSON"],
  "isLive": true,
  "isSold": false,
  "vehicle": {
    "make": "Chevrolet",
    "model": "Chevrolet Blazer EV",
    "trim": "SS",
    "odometer": { "unit": "MILES", "value": 311 },
    "transmission": "AUTOMATIC",
    "fuelType": "GASOLINE",
    "exteriorColor": "black",
    "interiorColor": "black",
    "condition": null,
    "titleStatus": "CLEAN",
    "numberOfOwners": null,
    "isPaidOff": "IS_PAID_OFF",
    "vin": null,
    "sellerType": "PRIVATE_SELLER",
    "features": [],
    "specifications": { "horse_power": null, "engine_size": null, "gas_mileage_combined": null }
  },
  "creation_time": 1763537117,
  "listingAgeText": "2 days ago",
  "searchedWord": "used cars"
}

Key Output Fields

Listing core

• itemUrl / listingUrl / facebookUrl — direct item URL, and the search/source URL.
• id — unique listing identifier.
• listingTitle / customTitle / description — title and full description (description requires includeSeller).
• listingPrice / strikethroughPrice — current and original price (amount, currency, formatted).
• location / locationText / latitude / longitude — city/state and precise GPS coordinates.
• listingPhotos — full array of photos (URIs, dimensions, alt captions); primaryListingPhoto is the thumbnail.
• listingVideo — pre-recorded videos when present.
• deliveryTypes — e.g. IN_PERSON, shipping.
• condition / listingAttributes — item condition and structured attributes.
• isLive / isSold / isPending / isHidden — availability status flags.
• creation_time / listingAgeText — Unix timestamp and human-readable age.
• seller — seller object (requires includeSeller).

vehicle (cars, trucks, RVs, boats)

• make / model / trim — vehicle identity.
• odometer — { unit, value } mileage.
• transmission / fuelType — drivetrain.
• exteriorColor / interiorColor — colors.
• titleStatus — e.g. CLEAN, SALVAGE; isPaidOff, numberOfOwners.
• vin — vehicle identification number when published.
• sellerType — e.g. PRIVATE_SELLER, dealer.
• specifications — engine size, horsepower, gas mileage, safety ratings (populated when Facebook provides them).
• features / carfaxReport — feature list and Carfax reference when present.

The vehicle object is null for non-vehicle listings. Individual fields populate based on what the seller and Facebook expose for each car.

What Makes This Richer Than Typical Marketplace Scrapers

Capability	Typical actors	This actor
Keyword search (no URL)	❌ URL-only	✅ searchQuery
Price / condition / delivery filters	❌	✅
Location radius + lat/long + precise	❌	✅
Monitoring mode (new-only)	❌	✅
Structured vehicle data	partial / none	✅ full vehicle object
Facebook login required	often yes	❌ optional
All photos + GPS	thumbnail only	✅

FAQ

Do I need a Facebook account or cookies? No. The actor runs cookie-free by default. You may supply cookies as an optional enhancement, but it is not required and there is no login step.

Can I search without building a URL? Yes — set searchQuery (and optionally marketplaceLocation / radiusKm / price / condition filters) and the actor builds the search for you.

Does every listing include vehicle data? Only vehicle listings (cars, trucks, RVs, boats) get a populated vehicle object; everything else has vehicle: null. Within vehicles, individual fields (e.g. VIN, mileage) populate when the seller and Facebook expose them.

How do I get all photos and the full description? Enable includeSeller — the actor then visits each item's detail page and returns the full listingPhotos array, description, attributes, and seller object.

How do I scrape only new listings? Enable monitoringMode and run on a schedule; the actor emits only listings not seen in previous runs.

Why are some fields null? Facebook doesn't expose every field for every listing (e.g. VIN or odometer may be omitted by the seller). The schema is stable; values reflect what's available.

Which proxy should I use? Residential proxies are strongly recommended for Facebook. Set the proxy country to match your target Marketplace region.

What export formats are supported? JSON, CSV, and Excel, plus the Apify API and integrations.

Support

• For issues or feature requests, use the Issues tab of this Actor.
• For customization or questions, contact the author:
  • Website: https://muhamed-didovic.github.io/
  • Email: muhamed.didovic@gmail.com

Additional Services

• Request customization or a full dataset: muhamed.didovic@gmail.com
• API access to this scraper (no Apify fee, usage-only): muhamed.didovic@gmail.com

Explore More Scrapers

Find more scrapers and automation tools on memo23's Apify profile — covering social platforms, job boards, ad libraries, and more.

⚠️ Disclaimer

This Actor accesses publicly available data on Facebook Marketplace for legitimate research, market-intelligence, and business-analysis purposes. Facebook and Facebook Marketplace are trademarks of Meta Platforms, Inc.; this Actor is not affiliated with, endorsed by, or sponsored by Meta. Use of this Actor must comply with Facebook's Terms of Service and all applicable laws, including data-protection regulations (GDPR, CCPA, etc.). Users must:

• Respect rate limits and avoid overloading Facebook's infrastructure
• Not use scraped data to violate user privacy or applicable terms
• Use the data in compliance with their jurisdiction
• Not republish scraped content in violation of copyright

We do not store any scraped data; the Actor returns it directly to your Apify dataset for your authorized use.

SEO Keywords

facebook marketplace scraper, facebook marketplace api, facebook marketplace data extraction, facebook marketplace vehicles scraper, facebook marketplace cars scraper, marketplace listings scraper, facebook marketplace search scraper, facebook marketplace price tracker, used car data scraper, vehicle listings api, facebook marketplace monitoring, marketplace lead generation, facebook marketplace csv export, facebook marketplace json, no-login marketplace scraper, apify facebook scraper, marketplace inventory tracking, second-hand goods data, facebook marketplace bulk export, car dealer data extraction