# Facebook Marketplace Scraper 💎 (`scraperpro/facebook-marketplace-scraper`) Actor The most data-rich Facebook Marketplace scraper on Apify. Extracts 40+ fields per listing — including seller intelligence, item details, vehicle specs, and HD images — for any category. No login required. - **URL**: https://apify.com/scraperpro/facebook-marketplace-scraper.md - **Developed by:** [ScraperPro](https://apify.com/scraperpro) (community) - **Categories:** E-commerce, Lead generation, Social media - **Stats:** 7 total users, 4 monthly users, 93.3% runs succeeded, 3 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Facebook Marketplace Scraper The most powerful and data-rich **Facebook Marketplace Scraper** on Apify. Extracts **40+ fields** per listing — including seller intelligence, complete item details, comprehensive vehicle specs, and HD images — for **any category**. No login required. Built-in residential proxy routing. Pay only for successful results. --- ### Facebook Marketplace Scraper Features When scraping Facebook Marketplace, you need reliability and deep data. Our scraper is enterprise-grade, designed to bypass Facebook's strict bot protections automatically using advanced residential proxies, ensuring you get exactly the data you need without the headache of managing proxies or accounts. #### Key Benefits: - **🔒 No Login Required:** Scrape anonymously without risking your personal Facebook account. - **⚡ Built-in Residential Proxies:** We handle the complex proxy routing and IP rotation. Our system automatically uses premium residential proxies to bypass blocks. **You do not need to buy your own proxies!** - **🆓 Risk-Free Trial:** Test the scraper instantly! Free users can use the trial allowance to scrape real listings using our premium proxies. - **💰 Pay-Per-Result:** You only pay for successful listings extracted. Zero hidden fees. - **🏎️ Blazing Fast:** Concurrent processing allows you to scrape up to 10x faster than sequential scrapers. --- ### 🎯 Use Cases Whether you are a data analyst, dropshipper, or car dealership, this scraper provides the raw intelligence you need: - **🚗 Car Dealerships & Flippers:** Extract VINs, mileage, transmission types, and body styles to find underpriced vehicles before anyone else. - **🏠 Real Estate Agents:** Scrape rental listings, property prices, and location data to analyze local housing markets. - **📦 Dropshippers & Resellers:** Monitor prices, discover trending electronics or furniture, and identify top-rated sellers. - **📊 Market Researchers:** Analyze pricing trends, seller sentiment, and regional availability across the US, UK, Canada, and beyond. --- ### 📊 What data does it extract? This scraper adapts to the category you are searching. It extracts generic fields for items like furniture, and automatically enriches vehicle listings with deep automotive specs. #### General Listing Output (Furniture, Electronics, Real Estate) ```json { "url": "https://www.facebook.com/marketplace/item/123456789/", "title": "IKEA Malm Dresser - Like New", "price": "$150", "city_slug": "sanfrancisco", "seller_name": "Sarah M.", "seller_join_year": "Joined Facebook in 2015", "seller_location": "San Francisco, CA", "seller_rating": 4.8, "seller_review_count": 12, "pseudo_seller_id": "anon_a3f2b1c9d8e7f6a5", "listing_age": "12 hours ago", "category": "Home & Garden", "description": "Selling my IKEA Malm 6-drawer dresser...", "condition": "PC_USED_LIKE_NEW", "brand": "IKEA", "images": ["https://scontent...jpg", "..."], "attributes": ["White", "6 drawers"] } ```` #### Automotive/Vehicle Output (Auto-Enriched) ```json { "url": "https://www.facebook.com/marketplace/item/982185697762732/", "title": "2019 Honda Civic EX", "price": "$8,500", "city_slug": "sanfrancisco", "seller_name": "Lawrence", "seller_rating": 4.6, "make": "Honda", "model": "Civic", "trim": "EX", "year": 2019, "mileage": "45000", "transmission": "AUTOMATIC", "fuel_type": "GASOLINE", "vin": "2HGFC2F5XKH...", "title_status": "CLEAN", "engine": "1.5L Turbo", "drivetrain": "FWD", "images": ["https://scontent...jpg"] } ``` *** ### 📥 Input Parameters The scraper is incredibly easy to configure. Simply provide your search term and location, and let the scraper do the rest! | Parameter | Type | Default | Description | |---|---|---|---| | `search_query` | string | `"vehicles"` | What to search for (e.g. 'iphone', 'honda', 'desk'). | | `city_slug` | string | `"sanfrancisco"` | Facebook city identifier (e.g. london, newyork, chicago). | | `min_price` | int | `1000` | Minimum price filter ($) | | `max_price` | int | `10000` | Maximum price filter ($) | | `max_results` | int | `100` | Maximum listings to scrape | | `concurrency` | int | `5` | Parallel scraping threads (1-10) for maximum speed. | | `days_since_listed` | int | `1` | Recency filter (1 = last 24h, 7 = last week). | | `proxy_country` | string | `""` | Target a specific country proxy (e.g., US, GB, CA, AU). | *** ### ❓ FAQ **Q: Do I need to buy my own residential proxies?**\ A: **No!** Because this Actor uses Pay-Per-Result pricing, it automatically uses our premium residential proxies behind the scenes. You simply pay for the successful results you receive. **Q: Do I need a Facebook account?**\ A: No. The scraper operates completely anonymously without any login or authentication required. **Q: Can I test it for free?**\ A: Yes! Free users can use the platform's free allowance to test the scraper. Because we route the proxy for you, your free test will actually work and return real data! **Q: How fast is it?**\ A: With concurrency set to 5, expect ~100 listings in 3-5 minutes. **Q: How do I scrape Facebook Marketplace?** A: You can easily scrape Facebook Marketplace using this Apify Actor. Just provide the search query (e.g. "iPhone" or "Honda") and the city slug (e.g. "sanfrancisco"), and the scraper will automatically navigate the site, bypass protections using residential proxies, and return the listings in JSON or CSV format. **Q: Is it legal to scrape Facebook Marketplace?** A: Scraping publicly available data is generally considered legal, but you should always review Apify's ethical guidelines and Facebook's terms of service. This scraper only extracts public data that any user would see when browsing Marketplace. **Q: Can you scrape Facebook Marketplace for cars and real estate?** A: Yes! This Facebook Marketplace scraper is specially optimized for vehicles and real estate. For cars, it automatically extracts VINs, mileage, transmission, and more. For real estate, it captures rental prices and locations. **Q: How to scrape data from Facebook Marketplace automatically?** A: You can run this Actor on a schedule using Apify's built-in scheduler, or integrate it into your own applications via the Apify API to automate your data collection pipeline. *** *Keywords: Facebook Marketplace scraper, Facebook data extraction, FB Marketplace API, scrape Facebook cars, real estate scraper, dropshipping product research, lead generation.* # Actor input Schema ## `search_query` (type: `string`): What to search for (e.g. 'vehicles', 'iphone', 'furniture', 'honda civic'). ## `city_slug` (type: `string`): The marketplace city slug (e.g. sanfrancisco, newyork, losangeles, chicago, houston). ## `min_price` (type: `integer`): Minimum listing price in dollars. ## `max_price` (type: `integer`): Maximum listing price in dollars. ## `max_results` (type: `integer`): Maximum number of listings to scrape. ## `concurrency` (type: `integer`): Number of listings to scrape in parallel (higher = faster, but more proxy usage). Recommended: 3-5 for residential proxies. ## `days_since_listed` (type: `integer`): Only scrape listings posted within this many days (1 = last 24h, 7 = last week, 30 = last month). ## `item_condition` (type: `string`): Filter by item condition. ## `radius` (type: `integer`): Search radius in kilometers. Max 500 for unauthenticated scraping. ## `proxy_country` (type: `string`): Specific country code for proxies (e.g. US, GB, CA, AU). Leave empty to use auto-assigned proxy locations. ## Actor input object example ```json { "search_query": "vehicles", "city_slug": "sanfrancisco", "min_price": 1000, "max_price": 10000, "max_results": 10, "concurrency": 5, "days_since_listed": 1, "item_condition": "used", "radius": 500, "proxy_country": "" } ``` # Actor output Schema ## `results` (type: `string`): Structured data for the scraped Facebook Marketplace listings, including seller intelligence and vehicle specs. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "search_query": "vehicles", "city_slug": "sanfrancisco", "min_price": 1000, "max_price": 10000, "max_results": 10, "concurrency": 5, "days_since_listed": 1, "item_condition": "used", "radius": 500, "proxy_country": "" }; // Run the Actor and wait for it to finish const run = await client.actor("scraperpro/facebook-marketplace-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "search_query": "vehicles", "city_slug": "sanfrancisco", "min_price": 1000, "max_price": 10000, "max_results": 10, "concurrency": 5, "days_since_listed": 1, "item_condition": "used", "radius": 500, "proxy_country": "", } # Run the Actor and wait for it to finish run = client.actor("scraperpro/facebook-marketplace-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "search_query": "vehicles", "city_slug": "sanfrancisco", "min_price": 1000, "max_price": 10000, "max_results": 10, "concurrency": 5, "days_since_listed": 1, "item_condition": "used", "radius": 500, "proxy_country": "" }' | apify call scraperpro/facebook-marketplace-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperpro/facebook-marketplace-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper 💎", "description": "The most data-rich Facebook Marketplace scraper on Apify. Extracts 40+ fields per listing — including seller intelligence, item details, vehicle specs, and HD images — for any category. No login required.", "version": "0.0", "x-build-id": "Bifz9xj2IkcOOekLJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperpro~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperpro-facebook-marketplace-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scraperpro~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-scraperpro-facebook-marketplace-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scraperpro~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-scraperpro-facebook-marketplace-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "search_query", "city_slug", "max_results" ], "properties": { "search_query": { "title": "Search Query", "type": "string", "description": "What to search for (e.g. 'vehicles', 'iphone', 'furniture', 'honda civic').", "default": "vehicles" }, "city_slug": { "title": "City Slug", "type": "string", "description": "The marketplace city slug (e.g. sanfrancisco, newyork, losangeles, chicago, houston).", "default": "sanfrancisco" }, "min_price": { "title": "Minimum Price ($)", "type": "integer", "description": "Minimum listing price in dollars.", "default": 1000 }, "max_price": { "title": "Maximum Price ($)", "type": "integer", "description": "Maximum listing price in dollars.", "default": 10000 }, "max_results": { "title": "Max Results", "type": "integer", "description": "Maximum number of listings to scrape.", "default": 10 }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of listings to scrape in parallel (higher = faster, but more proxy usage). Recommended: 3-5 for residential proxies.", "default": 5 }, "days_since_listed": { "title": "Days Since Listed", "type": "integer", "description": "Only scrape listings posted within this many days (1 = last 24h, 7 = last week, 30 = last month).", "default": 1 }, "item_condition": { "title": "Item Condition", "enum": [ "all", "new", "used" ], "type": "string", "description": "Filter by item condition.", "default": "used" }, "radius": { "title": "Search Radius (km)", "type": "integer", "description": "Search radius in kilometers. Max 500 for unauthenticated scraping.", "default": 500 }, "proxy_country": { "title": "Proxy Country (Optional)", "type": "string", "description": "Specific country code for proxies (e.g. US, GB, CA, AU). Leave empty to use auto-assigned proxy locations.", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```