# Facebook Marketplace Scraper (`flipper_ai/facebook-marketplace-scraper`) Actor Scrape Facebook Marketplace by keyword or browse whole categories (Vehicles, Furniture, Tools + 18 more) with no Facebook login. Returns price, title, year, location, image, and listing URL, newest first. Export JSON, CSV, Excel, or use as a Facebook Marketplace API. - **URL**: https://apify.com/flipper\_ai/facebook-marketplace-scraper.md - **Developed by:** [Josh Baker](https://apify.com/flipper_ai) (community) - **Categories:** E-commerce, Social media - **Stats:** 2 total users, 1 monthly users, 60.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.99 / 1,000 listing scrapeds 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 πŸ›’ **Scrape Facebook Marketplace listings into clean, structured data β€” by keyword or whole category, with no Facebook login needed.** Search any product (`pickup truck`, `iPhone`, `couch`) or browse an entire category (Vehicles, Furniture, Tools, Boats…) around any major city, and get every matching listing with **price, title, year, location, image, and a direct link** β€” sorted newest-first and ready to export as **JSON, CSV, or Excel**, or pull straight from the API. Built for **car flippers, dealers, resellers, lead-gen teams, and market researchers** who need to spot new listings fast β€” before the competition does. --- ### βœ… Why people use this Facebook Marketplace scraper - ⚑ **Fresh listings, sorted newest-first** β€” catch deals the moment they post - πŸ”“ **No Facebook account or login** β€” it reads public listings - πŸ—‚οΈ **Browse whole categories** β€” every new Vehicle / Furniture / Tool listing near a city, no keyword guessing - πŸš— **Auto-parses the year** from each listing title (built for vehicle sourcing) - 🌎 **Any location, any keyword** β€” full price-range and radius filters - πŸ“€ **Export anywhere** β€” JSON / CSV / Excel download, API, Google Sheets, Zapier, Make - πŸ” **Schedule it** β€” run daily or hourly and get new listings on autopilot - πŸ’Έ **Cheap** β€” pay only per listing you get ($1.99 / 1,000 results) --- ### πŸš€ How to scrape Facebook Marketplace in 30 seconds 1. Enter one or more **search queries** (e.g. `pickup truck`, `dresser`) β€” **or** pick a **category** to browse instead (e.g. Vehicles, Furniture, Tools). Use one or the other: Facebook can't combine them, so if both are set the search queries win and the category is ignored (with a warning in the log). 2. Enter a **location** β€” a city or `City, State` (e.g. `Pensacola, FL`, `Houston, TX`). Use a city big enough to have its own Marketplace page β€” for small towns, pick the nearest larger city and rely on the radius (the run fails with a clear error if Facebook doesn't recognize the city, and nothing is charged). 3. Set your price range and click **Start**. That's it. Results appear in the dataset β€” export or pull via API. --- ### πŸ“€ What data does it extract from Facebook Marketplace? Each listing comes back as a structured record: ```json { "query": "pickup truck", "price": 9995, "year": 2007, "title": "2007 Toyota Tacoma SR5", "location": "Pensacola, FL", "url": "https://www.facebook.com/marketplace/item/1447938003722445/", "image": "https://scontent.xx.fbcdn.net/...jpg" } ```` Fields that always come through: **price, title, location, image, and the listing link** β€” plus **year** parsed from the title (vehicles) and the **category** on category browses. *** ### πŸ”Œ Use it as a Facebook Marketplace API There is no official Facebook Marketplace API β€” this actor is the practical alternative. Every run's results are available through the [Apify API](https://docs.apify.com/api/v2) as JSON, so you can: - call it from any language (Node.js, Python, cURL) and read the dataset - **schedule runs** (hourly / daily) and fetch only new listings - fire **webhooks** when a run finishes - push results into **Google Sheets, Zapier, Make, Slack** and other integrations ### πŸ”” How to monitor Facebook Marketplace for new listings Results are sorted newest-first, so a scheduled run is a ready-made alert pipeline: schedule the actor (e.g. every morning for `Vehicles` in your city with your max price), then export or webhook the results. You'll see every new listing without ever scrolling the feed. *** ### 🎯 Who is it for? - **Car flippers & dealers** β€” source under-market vehicles across a whole metro - **Resellers & deal hunters** β€” track furniture, electronics, tools, anything - **Researchers & analysts** β€” pull Marketplace pricing data at scale - **Developers** β€” a clean API for Facebook Marketplace data *** ### πŸ’‘ FAQ #### Can you scrape Facebook Marketplace without an account? Yes β€” this scraper reads public listings and never logs in. No Facebook account, cookies, or session tokens needed. #### Which categories can I browse? `vehicles`, `motorcycles`, `boats`, `propertyrentals`, `apparel`, `electronics`, `entertainment`, `family`, `free`, `garden`, `home-improvements`, `instruments`, `office-supplies`, `pets`, `sports`, `toys`, `video-games`, `antiques`, `appliances`, `furniture`, `tools`. Price filters and newest-first sorting apply on category browses too. #### Does the radius work on category browses? No β€” that's a Facebook limitation, not a setting. On its public category pages Facebook always shows its default area around the chosen city and ignores the radius parameter (keyword searches respect it). Category results typically cover the city's metro area. #### Why is there no mileage field? Facebook doesn't show odometer readings on its public Marketplace search results, so it can't be scraped reliably and isn't included. The fields that always come through: price, year, title, location, image, and the listing link. #### My city fails with "not recognized as a Marketplace city" Facebook only has Marketplace pages for larger cities β€” small towns get redirected. Enter the nearest bigger city (e.g. `New Orleans, LA` instead of `Picayune`) and set the radius to cover your area. Failed runs like this save and charge nothing. #### Why does it use residential proxies? Facebook blocks datacenter IPs. Residential proxies are what make it work reliably (the default setting handles this for you). #### How much does it cost to scrape Facebook Marketplace? $1.99 per 1,000 listings scraped β€” you only pay for results you actually get. Empty, blocked, or failed runs charge nothing. #### Is scraping Facebook Marketplace legal? It accesses publicly available data. You're responsible for how you use the data and for complying with applicable laws and terms. *** ### πŸ› οΈ Input reference | Field | Description | |---|---| | `searchQueries` | One or more search terms (leave empty when browsing a category) | | `category` | Browse a whole category instead of searching (leave queries empty) | | `location` | Pick a major city from the dropdown, or use "Other city" below | | `customLocation` | Any other city as free text, `City, State` (overrides the dropdown) | | `minPrice` / `maxPrice` | Price range filter (works in both modes) | | `radius` | Search radius in miles (keyword searches only β€” Facebook ignores it on category pages) | | `maxItems` | Max unique listings to return | | `proxyConfiguration` | Residential proxies (recommended, on by default) | *** ### πŸ”— Related actors - [Facebook Marketplace Deals Scraper](https://apify.com/flipper_ai/fb-marketplace-deals-scraper) β€” the deal-hunting setup of this scraper: monitor whole categories in your city and catch underpriced listings first. *** *Not affiliated with, endorsed by, or sponsored by Meta or Facebook. "Facebook" and "Facebook Marketplace" are trademarks of Meta Platforms, Inc.* # Actor input Schema ## `searchQueries` (type: `array`): What to search for on Marketplace. Ignored when Category browse is selected. ## `category` (type: `string`): Optional. Browse a whole Marketplace category instead of keyword search. If search queries are also set, the queries win and this category is ignored (Facebook can't combine them) β€” a warning appears in the log and run status. ## `location` (type: `string`): Pick a city (every entry live-verified to have its own Marketplace page β€” US + Canada). Not listed? Use 'Other city' below β€” it overrides this dropdown. ## `customLocation` (type: `string`): Any other city as 'City, State'. Must be big enough to have its own Marketplace page β€” small towns fail with a clear error and are never charged. ## `radius` (type: `integer`): How far from the location to search. ## `minPrice` (type: `integer`): Skip listings priced below this. ## `maxPrice` (type: `integer`): Skip listings priced above this. ## `maxItems` (type: `integer`): Stop after collecting this many unique listings (across all queries). Facebook loads results by scrolling, so very large values may return fewer if Facebook stops loading more. ## `includeRelated` (type: `boolean`): Facebook pads search results with loosely-related listings (search 'tacoma', get F-150s at the end). By default those are filtered out so you only get listings containing your search words. Turn this on to keep them. Only affects keyword searches. ## `proxyConfiguration` (type: `object`): Facebook blocks datacenter IPs, so RESIDENTIAL proxies are strongly recommended. This is required for reliable results. ## Actor input object example ```json { "searchQueries": [ "toyota tacoma", "ford f-150" ], "category": "", "location": "Pensacola, FL", "radius": 100, "minPrice": 0, "maxPrice": 100000, "maxItems": 100, "includeRelated": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "location": "Pensacola, FL", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("flipper_ai/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 = { "location": "Pensacola, FL", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("flipper_ai/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 '{ "location": "Pensacola, FL", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call flipper_ai/facebook-marketplace-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=flipper_ai/facebook-marketplace-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper", "description": "Scrape Facebook Marketplace by keyword or browse whole categories (Vehicles, Furniture, Tools + 18 more) with no Facebook login. Returns price, title, year, location, image, and listing URL, newest first. Export JSON, CSV, Excel, or use as a Facebook Marketplace API.", "version": "0.1", "x-build-id": "mdJFX73mjZ3flVmw7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flipper_ai~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flipper_ai-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/flipper_ai~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-flipper_ai-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/flipper_ai~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-flipper_ai-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", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "What to search for on Marketplace. Ignored when Category browse is selected.", "items": { "type": "string" } }, "category": { "title": "Category browse", "enum": [ "", "vehicles", "motorcycles", "boats", "propertyrentals", "apparel", "electronics", "entertainment", "family", "free", "garden", "home-improvements", "instruments", "office-supplies", "pets", "sports", "toys", "video-games", "antiques", "appliances", "furniture", "tools" ], "type": "string", "description": "Optional. Browse a whole Marketplace category instead of keyword search. If search queries are also set, the queries win and this category is ignored (Facebook can't combine them) β€” a warning appears in the log and run status.", "default": "" }, "location": { "title": "Location (major city)", "enum": [ "Albuquerque, NM", "Anchorage, AK", "Atlanta, GA", "Austin, TX", "Baltimore, MD", "Baton Rouge, LA", "Birmingham, AL", "Boise, ID", "Boston, MA", "Buffalo, NY", "Calgary, AB", "Charleston, SC", "Charlotte, NC", "Chicago, IL", "Cincinnati, OH", "Cleveland, OH", "Colorado Springs, CO", "Columbus, OH", "Dallas, TX", "Denver, CO", "Des Moines, IA", "Detroit, MI", "Edmonton, AB", "El Paso, TX", "Fort Worth, TX", "Fresno, CA", "Grand Rapids, MI", "Halifax, NS", "Hamilton, ON", "Honolulu, HI", "Houston, TX", "Huntsville, AL", "Indianapolis, IN", "Jacksonville, FL", "Kansas City, MO", "Knoxville, TN", "Las Vegas, NV", "Lexington, KY", "Little Rock, AR", "Los Angeles, CA", "Louisville, KY", "Madison, WI", "Memphis, TN", "Miami, FL", "Milwaukee, WI", "Minneapolis, MN", "Montreal, QC", "Nashville, TN", "New Orleans, LA", "New York, NY", "Oakland, CA", "Omaha, NE", "Orlando, FL", "Ottawa, ON", "Panama City, FL", "Pensacola, FL", "Philadelphia, PA", "Phoenix, AZ", "Pittsburgh, PA", "Portland, OR", "Providence, RI", "Raleigh, NC", "Richmond, VA", "Rochester, NY", "Sacramento, CA", "Salt Lake City, UT", "San Antonio, TX", "San Diego, CA", "San Francisco, CA", "San Jose, CA", "Seattle, WA", "Spokane, WA", "St. Louis, MO", "Syracuse, NY", "Tampa, FL", "Toronto, ON", "Tucson, AZ", "Tulsa, OK", "Vancouver, BC", "Virginia Beach, VA", "Washington, DC", "Wichita, KS", "Winnipeg, MB" ], "type": "string", "description": "Pick a city (every entry live-verified to have its own Marketplace page β€” US + Canada). Not listed? Use 'Other city' below β€” it overrides this dropdown." }, "customLocation": { "title": "Other city (overrides the dropdown)", "type": "string", "description": "Any other city as 'City, State'. Must be big enough to have its own Marketplace page β€” small towns fail with a clear error and are never charged." }, "radius": { "title": "Search radius (miles)", "type": "integer", "description": "How far from the location to search.", "default": 100 }, "minPrice": { "title": "Minimum price", "type": "integer", "description": "Skip listings priced below this.", "default": 0 }, "maxPrice": { "title": "Maximum price", "type": "integer", "description": "Skip listings priced above this.", "default": 100000 }, "maxItems": { "title": "Max results", "type": "integer", "description": "Stop after collecting this many unique listings (across all queries). Facebook loads results by scrolling, so very large values may return fewer if Facebook stops loading more.", "default": 100 }, "includeRelated": { "title": "Include Facebook's related suggestions", "type": "boolean", "description": "Facebook pads search results with loosely-related listings (search 'tacoma', get F-150s at the end). By default those are filtered out so you only get listings containing your search words. Turn this on to keep them. Only affects keyword searches.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Facebook blocks datacenter IPs, so RESIDENTIAL proxies are strongly recommended. This is required for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```