# Facebook Marketplace Deals Scraper (`flipper_ai/fb-marketplace-deals-scraper`) Actor Find deals on Facebook Marketplace automatically: monitor whole categories (Vehicles, Furniture, Free, Tools + more) or keywords in any city, newest listings first with price filters. No Facebook login. Export JSON, CSV, Excel, or automate via API and schedules. - **URL**: https://apify.com/flipper\_ai/fb-marketplace-deals-scraper.md - **Developed by:** [Josh Baker](https://apify.com/flipper_ai) (community) - **Categories:** E-commerce, Social media - **Stats:** 4 total users, 1 monthly users, 33.3% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.00005 / actor start This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Deals Scraper πŸ’° **Find deals on Facebook Marketplace before anyone else. Every new listing in your city β€” cars, furniture, tools, even free stuff β€” delivered as clean data, sorted newest-first.** The best Marketplace deals are gone in hours. This scraper watches a whole **category** (Vehicles, Furniture, Tools, Free…) or any **keyword** around your city and returns each listing with **price, title, year, location, image, and a direct link** β€” no Facebook login needed. Schedule it daily or hourly and you're first in line, without ever scrolling the feed. --- ### 🎯 How to find deals on Facebook Marketplace automatically 1. Pick a **category** to monitor (e.g. Vehicles, Furniture, Free) β€” or enter **search keywords** instead (e.g. `golf cart`, `mid century dresser`). 2. Pick your **city** (or type any larger city as `City, State`). 3. Set a **max price** β€” that's your deal threshold. 4. **Schedule it** (daily or hourly). New listings arrive sorted newest-first, exportable as JSON, CSV, or Excel, or straight into Google Sheets / Zapier / Make via the API. Runs that hit an unrecognized city or get blocked **fail clearly and charge nothing** β€” no silent junk data. --- ### πŸ”₯ Deal-hunting recipes #### Cheap cars near you (cars under $5,000) Category `vehicles` + your city + `maxPrice: 5000`, scheduled every morning. Every under-market car, truck, and SUV posted in the last day, newest first, with the year parsed from the title β€” a car flipper's sourcing feed. #### Free stuff on Facebook Marketplace Category `free` + your city. People give away furniture, appliances, and tools every day β€” the only winners are the ones who see the listing first. #### Furniture flips Category `furniture` + `maxPrice: 100`. Solid-wood dressers and mid-century pieces get listed cheap constantly; resellers routinely 3–5x them. #### Tools, electronics, appliances Same play: category + max price + daily schedule. Estate cleanouts and movers price to sell fast. --- ### πŸ“€ Example output ```json { "category": "vehicles", "price": 4500, "year": 2009, "title": "2009 Honda Civic LX", "location": "Houston, TX", "url": "https://www.facebook.com/marketplace/item/1447938003722445/", "image": "https://scontent.xx.fbcdn.net/...jpg" } ```` *** ### βœ… Why deal hunters use it - ⚑ **Newest-first sorting** β€” the whole point of deal hunting is being early - πŸ—‚οΈ **Watch entire categories** β€” no keyword guessing, nothing slips past - πŸ”“ **No Facebook account or login** β€” reads public listings - πŸ’΅ **Price filters** β€” only see listings under your threshold - πŸš— **Year auto-parsed** from vehicle titles - πŸ” **Set-and-forget schedules** β€” your deal feed runs while you sleep - πŸ“€ **Export anywhere** β€” JSON / CSV / Excel, API, Google Sheets, Zapier, Make *** ### πŸ’‘ FAQ #### Do I need a Facebook account? No β€” it reads public listings. No login, cookies, or session tokens. #### Which categories can I monitor? `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 work on all of them. #### Keywords or category β€” which should I use? Category mode is the deal-hunting mode: it catches everything, including badly titled listings a keyword search would miss (the "dresser" listed as "wood thing"). Use keywords when you want one specific item. Use one or the other per run β€” Facebook's public category pages ignore keywords, so the run stops with a clear message if both are set. #### My city fails with "not recognized as a Marketplace city" Facebook only has Marketplace pages for larger cities. Enter the nearest bigger city (e.g. `New Orleans, LA` instead of `Picayune`) β€” failed runs charge nothing. #### Does the radius work on category browses? No β€” a Facebook limitation. Category pages always cover the city's default metro area (keyword searches respect the radius). #### How much does it cost? Pay-per-result: you're only charged for listings actually delivered β€” empty, blocked, or failed runs cost nothing. **Launch pricing is currently active**, so it's close to free to try. #### Is this 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 | |---|---| | `category` | The category to monitor (the deal-hunting mode) | | `searchQueries` | Or: one or more search terms (leave category 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 β€” your deal threshold | | `radius` | Search radius in miles (keyword searches only) | | `maxItems` | Max unique listings to return | | `proxyConfiguration` | Residential proxies (recommended, on by default) | *** ### πŸ”— Related actors - [Facebook Marketplace Scraper](https://apify.com/flipper_ai/facebook-marketplace-scraper) β€” the general-purpose version: keyword search with radius filters, built for data extraction at scale. *** *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/fb-marketplace-deals-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/fb-marketplace-deals-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/fb-marketplace-deals-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=flipper_ai/fb-marketplace-deals-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Deals Scraper", "description": "Find deals on Facebook Marketplace automatically: monitor whole categories (Vehicles, Furniture, Free, Tools + more) or keywords in any city, newest listings first with price filters. No Facebook login. Export JSON, CSV, Excel, or automate via API and schedules.", "version": "0.1", "x-build-id": "I5NMPgDy99ycvoQ4G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flipper_ai~fb-marketplace-deals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flipper_ai-fb-marketplace-deals-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~fb-marketplace-deals-scraper/runs": { "post": { "operationId": "runs-sync-flipper_ai-fb-marketplace-deals-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~fb-marketplace-deals-scraper/run-sync": { "post": { "operationId": "run-sync-flipper_ai-fb-marketplace-deals-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 } } } } } } } } } } ```