🛒 Facebook Marketplace Scraper

🚀 Pull public Facebook Marketplace listings by city and search term. Export titles, prices, categories, brands, vehicle specs, real-estate details, seller names and direct listing URLs into clean JSON, CSV or Excel.

🕒 Last updated: 2026-04-24 · 📊 29 fields per listing · 🚗 Vehicle specs · 🏡 Real-estate fields · 🌆 City-based search

The Facebook Marketplace Scraper queries Marketplace by city and keyword, paginates through the search feed, and returns each listing as a flat JSON record with 29 fields. The dataset covers titles, current price, currency, primary photo, seller name and id, category and subcategory, brand, condition, listing URL, delivery options, and typed blocks for vehicles (make, model, year, mileage, condition, transmission, fuel type) and real estate (bedrooms, bathrooms, square footage, property type).

The Actor classifies each listing into one of four types (general product, vehicle, rental or home-for-sale) based on the hydrated search feed plus title heuristics, so you can filter the output without post-processing. Vehicle fallback parses year, make and model from the title so older listings that don't expose structured vehicle fields still get typed.

🎯 Target Audience	💡 Primary Use Cases
Used-goods resellers, real-estate analysts, auto dealers, market researchers, price intelligence teams, data scientists	Price monitoring, inventory discovery, used-car pricing, rental market mapping, arbitrage detection, competitor listing analysis

---

📋 What the Facebook Marketplace Scraper does

Five common workflows in a single run:

• 🛒 City + keyword search. Pass a city slug and a query, get the current Marketplace feed.
• 🚗 Vehicle typed fields. Year, make, model, mileage, condition, transmission and fuel when Facebook exposes them, with title-based fallbacks for the rest.
• 🏡 Real-estate typed fields. Bedrooms, bathrooms, square footage and property type for rentals and homes for sale.
• 🏷️ Brand, category and delivery. Structured category, subcategory, brand and delivery-option tags per listing.
• 🔗 Direct listing URLs. Every record includes the canonical marketplace URL for follow-up.

💡 Why it matters: Marketplace has no official export and no public search API. Scraper alternatives usually return 5-10 fields and break when Facebook changes class names. This Actor reads the hydration JSON behind the search page, so the schema is stable and the output is already typed.

---

⚙️ Input

Input	Type	Default	Behavior
searchQueries	array of objects	required*	Each object is { city: "nyc", query: "iphone" }. City is the Marketplace URL slug.
startUrls	array of URLs	required*	Alternative: direct marketplace item URLs to scrape one by one.
maxItems	integer	10	Global cap on returned listings across all queries. Free plan tops out at 10.
enrichListings	boolean	true	Attempts detail-page enrichment when Facebook allows it. Falls back to search-feed metadata when detail pages require login.
proxyConfiguration	object	residential	Override the proxy group if you need a specific country.

* Provide at least one of searchQueries or startUrls.

---

📊 Output

Every listing is returned as a flat JSON record with 29 fields.

🧾 Key fields

Field	Type	Description
listingId	string	Stable Marketplace listing id.
title	string	Listing title.
price	number	Listed price as a number. Null for free items.
currency	string	ISO currency code when Facebook exposes it.
location	string	City name or region as displayed in the feed.
category	string	Marketplace category label.
subCategory	string	Deeper category label when available.
brand	string	Structured brand when Facebook exposes it.
listingType	string	One of product, vehicle, rental, home-for-sale.
url	string	Canonical marketplace URL.
images	array of strings	Image URLs.
sellerName	string	Seller display name.
sellerUrl	string	Seller profile URL.
condition	string	New, used-like-new, used-good and so on.
deliveryOptions	array of strings	Pickup, shipping or both.
vehicleMake	string	Manufacturer (vehicle listings).
vehicleModel	string	Model (vehicle listings).
vehicleYear	integer	Model year (vehicle listings).
vehicleMileage	integer	Odometer reading (vehicle listings).
vehicleCondition	string	Structured condition label.
transmission	string	Automatic, manual, etc.
fuelType	string	Gasoline, diesel, electric, hybrid.
bedrooms	integer	Bedroom count (rentals and homes).
bathrooms	number	Bathroom count (rentals and homes).
sqft	integer	Interior square footage.
propertyType	string	Apartment, house, condo, etc.
postedDate	ISO 8601	Creation timestamp when Facebook exposes it.
isAvailable	boolean	True when the listing is live and unsold.
scrapedAt	ISO 8601	Run timestamp.

📦 Sample record

{
  "listingId": "1065433001234567",
  "title": "2017 Honda Civic · LX Sedan 4D",
  "price": 12500,
  "currency": "USD",
  "location": "Los Angeles, CA",
  "category": "Vehicles",
  "subCategory": "Cars",
  "brand": "Honda",
  "listingType": "vehicle",
  "url": "https://www.facebook.com/marketplace/item/1065433001234567/",
  "images": ["https://scontent.fqfd1-1.fna.fbcdn.net/..."],
  "sellerName": "Juan Perez",
  "sellerUrl": "https://www.facebook.com/profile.php?id=100001...",
  "condition": "used-good",
  "deliveryOptions": ["pickup"],
  "vehicleMake": "Honda",
  "vehicleModel": "Civic",
  "vehicleYear": 2017,
  "vehicleMileage": 87500,
  "vehicleCondition": "used-good",
  "transmission": "automatic",
  "fuelType": "gasoline",
  "bedrooms": null,
  "bathrooms": null,
  "sqft": null,
  "propertyType": null,
  "postedDate": "2026-04-20T15:02:00.000Z",
  "isAvailable": true,
  "scrapedAt": "2026-04-24T12:00:00.000Z"
}

---

✨ Why choose this Actor

• Typed categories. Vehicle and real-estate listings come with structured fields so you can filter without regex.
• 29 fields per listing. Most alternatives return title, price and an image. This one includes brand, condition, delivery, seller and postedDate.
• Stable against redesigns. Reads the hydration JSON rather than parsing DOM, so small UI tweaks don't break the output.
• No tokens or accounts. Anonymous access to public search feeds.
• Ready for BI tools. CSV and Excel export match your spreadsheet columns directly.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ Facebook Marketplace Scraper (this Actor)	$5 free credit, then pay-per-use	Full source coverage	Live per run	Source-native filters supported	⚡ 2 min
Build your own scraper	Engineering hours	Full once built	Whenever you maintain it	Custom code	🐢 Days to weeks
Paid managed APIs	$$$ monthly	Vendor-defined	Live	Vendor-defined	⏳ Hours
Third-party data dumps	Varies	Subset, often stale	Periodic	None	🕒 Variable

Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance.

---

🚀 How to use

1. Pick a Marketplace city slug (e.g. nyc, losangeles, miami, chicago).
2. Add a search query per city in searchQueries.
3. Set maxItems, run the Actor, and download JSON, CSV or Excel.
4. Sort by listingType to split vehicles, rentals and general products.

---

🎯 Business Use Cases

• 📊 Price Intelligence Teams - Track pricing trends by brand, condition, and city to spot arbitrage opportunities across metros
• 🚗 Auto Dealers - Feed vehicle year, mileage, and price into depreciation models and benchmark against Kelley Blue Book or local dealer data
• 🏡 Real Estate Analysts - Map rental and for-sale inventory by neighborhood, track bedrooms and square footage pricing, and compare against MLS feeds
• 💼 Resellers and Arbitrage - Surface new listings in your category daily, filter by brand and condition, and route alerts when targets hit a price ceiling

---

🔌 Automating Facebook Marketplace Scraper

• Schedule runs per city so pricing and inventory stay current.
• Pipe results into Google Sheets, Airtable, Notion, BigQuery or a custom webhook.
• Fire alerts through Slack or email when a listing matches your target price.
• Call the Apify REST API for custom orchestration from your own backend.

---

💼 Business use cases

📊 Data & Analytics Build trend reports and dashboards from live source data Feed BI tools, warehouses, and ML pipelines with structured records Run periodic snapshots to track changes over time Compare segments, regions, or categories with consistent fields	🏢 Operations & Strategy Monitor competitor moves, pricing, and inventory shifts Build internal directories and lookup tools backed by current data Power workflows that depend on fresh source records Cut manual data-gathering time from hours to minutes
🎯 Marketing & Growth Identify market opportunities and trending topics Research target audiences and customer personas at scale Power lead-generation pipelines with verified records Track sentiment, reviews, or social signals over time	🛠️ Engineering & Product Prototype features that need real-world data without owning a crawler Replace fragile in-house scrapers with a managed Actor Wire datasets into your apps via the Apify API or webhooks Skip the proxy, retry, and parsing maintenance entirely

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Urban planning and housing inventory studies Used-vehicle fleet tracking for transport research Reproducible research with cited, versioned dataset pulls Classroom exercises on market analysis and ethics	🎨 Personal and creative Side projects, portfolio demos, and indie app launches Hobbyists tracking project car parts and fixtures Bargain hunters monitoring local listings for deals DIY restorers sourcing materials across markets
🤝 Non-profit and civic Housing-justice analysis of rental pricing concentration Affordability reporting from informal rental inventory Investigative journalism on local commerce trends Community accountability databases with public listings	🧪 Experimentation Train price-prediction and condition-classification models Validate product hypotheses against real listing data Prototype agent pipelines for inventory discovery Test dashboard concepts with live marketplace data

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

Which cities are supported? Every Marketplace city. Pass the slug Facebook uses in the URL (e.g. nyc for New York, losangeles, miami, chicago, london, toronto).

Can I search by category rather than keyword? Use a category-style query (e.g. cars for sale, apartment for rent, used furniture). The Actor also classifies every listing into product, vehicle, rental or home-for-sale so you can filter downstream.

Do I get seller contact info? Seller name and profile URL yes. Facebook does not expose phone numbers or emails for Marketplace sellers publicly.

Why are some detail fields null? Facebook gates item detail pages behind login for anonymous traffic. The Actor falls back to the search-feed hydration data, which covers 29 fields reliably.

Do I need a Facebook account? No. The Actor runs anonymously.

How fresh is the data? Every run hits Marketplace live.

Can I get historical pricing? Schedule runs and store the dataset yourself. We don't maintain a price history in the Actor.

Does it support currencies other than USD? Yes. The currency field reflects whatever Facebook returns for each listing.

---

🔌 Integrate with any app

Works with Make, Zapier, n8n, Slack, LangChain, and 100+ other platforms. The Apify REST API is available for direct backend integration.

---

🔗 Recommended Actors

Actor	What it does
Facebook Comments Scraper	Pulls threaded comments, replies, reactions and mentions from any public Facebook post.
Facebook Groups Scraper	Pulls member count, privacy, rules and admin info from public Facebook groups.
Zillow Rentals Scraper	Rental listings with price, beds, baths and history from Zillow.
CarsForSale Scraper	Inventory and pricing from CarsForSale.com.
EquipmentTrader Scraper	Heavy equipment listings with full specs and seller details.

---

💡 Tips

• Run a small maxItems test first to confirm the city slug matches your target. Some cities use alternate spellings (e.g. sanfrancisco, not san-francisco).
• Use listingType as a downstream filter to split vehicles, rentals and general products before loading into your analytics tool.
• Schedule runs during off-peak hours. Marketplace refreshes its feed continuously, so evenings give the best new-inventory yield.

---

🆘 Support

Open a ticket at tally.so/r/BzdKgA and include the run id. Same-day replies on weekdays.

New to Apify? Create a free account with $5 credit and your first run is on the house.

---

⚠️ Disclaimer

This Actor collects only publicly accessible Marketplace listings. You are responsible for complying with Facebook's Terms of Service, local data-protection laws (GDPR, CCPA) and any applicable commercial-use rules. Do not use scraped contact details to send unsolicited communications.