# Facebook Marketplace ($0.10/1k results) + DIscord Alerts (`futurafree/facebook-marketplace-0-10-1k-results-discord-alerts`) Actor At $0.10 per 1000 results💲, this is an extremely CHEAP and FAST Facebook Marketplace scraper! Best for flippers and resellers. Instantly finds and sends the newest listings to your Discord for rapid sourcing and real-time alerts. Also supports mass scraping of listing info for analysis or research. - **URL**: https://apify.com/futurafree/facebook-marketplace-0-10-1k-results-discord-alerts.md - **Developed by:** [Gavin](https://apify.com/futurafree) (community) - **Categories:** Automation, Lead generation, Real estate - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.09 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## High-Efficiency Scraper: Pay for Raw Results **Pricing: $0.10 per 1,000 results.** Facebook delivers marketplace data in batches of **24 listings per page**. To keep our pricing transparent and sustainable, you are charged for the total number of raw results Facebook returns. This means you pay for the "scraped" data before your custom filters, like radius, keyword matches, or deduplication kick in. You pay for exactly what the scraper sees, ensuring you get the most comprehensive market coverage for a fraction of the cost of other tools. --- ### Important: Set Memory to 128 MB for Best Performance & Lowest Cost **Before running this actor, set the "Memory" option in the Run tab to the lowest value (128 MB).** This ensures the actor runs efficiently and you pay the lowest possible price. You can find this setting by scrolling all the way down and clicking before starting or scheduling a run. --- ### Facebook Marketplace Scraper Easily discover and collect the latest Facebook Marketplace listings that match your needs — delivered straight to you, with powerful filtering and instant notifications! --- ### Features - **Multi-Keyword Search:** Find multiple products or categories at once. - **Price Filtering:** Set your own minimum and maximum prices for each search. - **Location Targeting:** Get results tailored to your exact latitude and longitude. - **Keyword Filtering:** Only get listings that match your chosen keywords. - **Duplicate Prevention:** Never see the same listing twice — only fresh results! - **Discord Alerts:** Get instant notifications for new listings via your Discord webhook. - **Proxy Support:** Use Apify Proxy or your own custom proxy for reliable access. --- ### Pro Tip: Maximize Your Coverage **Want to catch every listing and ensure nothing slips past?** Set up multiple search terms for the same item with different timeframes: - **Search Term 1:** "iPhone" - last 24 hours - **Search Term 2:** "iPhone" - last 3 days - **Search Term 3:** "iPhone" - last 7 days This staggered approach creates overlapping coverage windows, dramatically reducing the chance of missing listings that might appear between your regular searches. The more coverage windows you create, the tighter your net becomes! --- ### Input Options | Field | Type | Required | Description | |----------------------|-----------|----------|-----------------------------------------------------------------------------| | `searchTerms` | array | Yes | List of keywords to search for (e.g., `["iPhone", "PS5"]`) | | `minPrices` | array | Yes | Minimum price for each search term - must match order (e.g., `["50", "100"]`) | | `maxPrices` | array | Yes | Maximum price for each search term - must match order (e.g., `["2000", "1000"]`) | | `daysListed` | array | Yes | Days since listed for each search term - must match order (e.g., `["1", "7"]`) | | `latitude` | string | Yes | Latitude for your search location (e.g., `"42.314938"`) | | `longitude` | string | Yes | Longitude for your search location (e.g., `"-83.0368"`) | | `proxyConfiguration` | object | Yes | Use Apify Proxy or provide your own proxy URLs | | `filterKeywords` | array | No | (Optional) Only save/send listings containing these keywords | | `discordWebhook` | string | No | (Optional) Discord webhook URL for instant notifications | | `listingsPerSearch` | integer | No | (Optional) Max listings per search term (default: 5) | | `useDeduplication` | boolean | No | (Optional) Enable/disable duplicate filtering (default: true) | --- ### Output Example Each result includes: ```json { "link": "https://www.facebook.com/marketplace/item/123456789/", "title": "iPhone 13 Pro Max", "price": "$800", "location": "Toronto, ON", "image_url": "https://...", "id": "123456789", "sources": [ { "search_term": "iPhone", "timeframe": "1 days" } ] } ```` *** ### Real-Time Alerts Want to be the first to know about new listings?\ **Use Apify's built-in scheduling system** to run this actor automatically every 1 minute, 2 minutes, or any interval you choose.\ Get real-time alerts and never miss a deal! *** ### Get Started 1. **Set your search terms, prices, and location.** 2. **Add filter keywords** (optional) to only see listings that matter to you. 3. **Add your Discord webhook** (optional) for instant notifications. 4. **Choose your proxy settings** (Apify Proxy recommended). 5. **Schedule the actor** for continuous, real-time results! *** **Stay ahead of the crowd and let the Facebook Marketplace Scraper do the searching for you!** *** ### Data Collection & Privacy This actor collects only **publicly available** Facebook Marketplace listing data. All information gathered comes from marketplace listings that are visible to **any user** browsing Facebook Marketplace. No private or personally identifiable Facebook user data is collected. The data extracted is limited to: - Item titles - Listed prices and general locations - Publicly visible listing images - Marketplace listing URLs This tool **does not** access private user profiles, messages, or any non-public information. Legal and ethical use is your responsibility. While this actor is designed to respect privacy and only process public data, you are responsible for ensuring your use complies with all relevant laws, regulations (such as GDPR, PIPEDA, or CCPA), and the terms of service of the websites you access. If you are unsure about your obligations or the legality of your use case, please consult a qualified legal professional. # Actor input Schema ## `searchTerms` (type: `array`): List of search terms (e.g. 'iphone', 'xbox') ## `minPrices` (type: `array`): List the minimum prices for your search terms, matching the order exactly. For example, if your search terms are 'iPhone', 'PS5', and you want $50 for iPhone and $100 for PS5, enter '50', '100'. ⚠️ The first price is for the first search term, the second price is for the second, and so on. ## `maxPrices` (type: `array`): List the maximum prices for your search terms, matching the order exactly. For example, if your search terms are 'iPhone', 'PS5', and you want $50 for iPhone and $100 for PS5, enter '50', '100'. ⚠️ The first price is for the first search term, the second price is for the second, and so on. ## `daysListed` (type: `array`): List the days since listed for your search terms, matching the order exactly. For example, if your search terms are 'iPhone', 'PS5', and you want 7 days for iPhone and 30 days for PS5, enter '7', '30'. ⚠️ The first number is for the first search term, the second number is for the second, and so on. ## `searchRadii` (type: `array`): Optional: Enter a search radius for each term. Max allowed is 130 km (higher values will be automatically capped). If you leave this blank or enter fewer radii than search terms, those specific searches will search everywhere with no distance limits. ## `latitude` (type: `string`): The latitude coordinate for the search location (e.g., '40.7128'). Can be negative, so make sure you get them right! You can find it with a quick Google search of where you live. ## `longitude` (type: `string`): The longitude coordinate for the search location (e.g., '-74.00608'). Can be negative, so make sure you get them right! You can find it with a quick Google search of where you live. ## `filterKeywords` (type: `array`): Only listings containing one or more of these keywords in the title will be saved and/or sent to Discord. ## `discordWebhook` (type: `string`): Paste your Discord webhook URL here to receive notifications for each found listing. Notifications are already designed for you. ## `listingsPerSearch` (type: `integer`): Maximum number of listings to scrape per search term. ## `useDeduplication` (type: `boolean`): Enable deduplication using processed listings file. Never be sent back a listing that's been found before. ## `pushToDataset` (type: `boolean`): Output to dataset. Auto-enabled if Discord webhook is disabled to ensure you get results. ## `proxyConfiguration` (type: `object`): Select proxies to use for the scraper. Apify Proxy is recommended. ## Actor input object example ```json { "searchTerms": [ "iPhone", "PS5" ], "minPrices": [ "50", "100" ], "maxPrices": [ "2000", "1000" ], "daysListed": [ "1", "7" ], "latitude": "43.653225", "longitude": "-79.383186", "filterKeywords": [ "iphone", "i-phone", "ps5", "playstation 5" ], "listingsPerSearch": 10, "useDeduplication": true, "pushToDataset": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "searchTerms": [ "iPhone", "PS5" ], "minPrices": [ "50", "100" ], "maxPrices": [ "2000", "1000" ], "daysListed": [ "1", "7" ], "latitude": "43.653225", "longitude": "-79.383186", "filterKeywords": [ "iphone", "i-phone", "ps5", "playstation 5" ], "listingsPerSearch": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("futurafree/facebook-marketplace-0-10-1k-results-discord-alerts").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 = { "searchTerms": [ "iPhone", "PS5", ], "minPrices": [ "50", "100", ], "maxPrices": [ "2000", "1000", ], "daysListed": [ "1", "7", ], "latitude": "43.653225", "longitude": "-79.383186", "filterKeywords": [ "iphone", "i-phone", "ps5", "playstation 5", ], "listingsPerSearch": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("futurafree/facebook-marketplace-0-10-1k-results-discord-alerts").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 '{ "searchTerms": [ "iPhone", "PS5" ], "minPrices": [ "50", "100" ], "maxPrices": [ "2000", "1000" ], "daysListed": [ "1", "7" ], "latitude": "43.653225", "longitude": "-79.383186", "filterKeywords": [ "iphone", "i-phone", "ps5", "playstation 5" ], "listingsPerSearch": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call futurafree/facebook-marketplace-0-10-1k-results-discord-alerts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=futurafree/facebook-marketplace-0-10-1k-results-discord-alerts", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Marketplace ($0.10/1k results) + DIscord Alerts", "description": "At $0.10 per 1000 results💲, this is an extremely CHEAP and FAST Facebook Marketplace scraper! Best for flippers and resellers. Instantly finds and sends the newest listings to your Discord for rapid sourcing and real-time alerts. Also supports mass scraping of listing info for analysis or research.", "version": "0.0", "x-build-id": "jj8CMuBN1APaALcIp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/futurafree~facebook-marketplace-0-10-1k-results-discord-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-futurafree-facebook-marketplace-0-10-1k-results-discord-alerts", "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/futurafree~facebook-marketplace-0-10-1k-results-discord-alerts/runs": { "post": { "operationId": "runs-sync-futurafree-facebook-marketplace-0-10-1k-results-discord-alerts", "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/futurafree~facebook-marketplace-0-10-1k-results-discord-alerts/run-sync": { "post": { "operationId": "run-sync-futurafree-facebook-marketplace-0-10-1k-results-discord-alerts", "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": [ "searchTerms", "minPrices", "maxPrices", "daysListed", "latitude", "longitude", "listingsPerSearch", "proxyConfiguration" ], "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "List of search terms (e.g. 'iphone', 'xbox')", "items": { "type": "string" } }, "minPrices": { "title": "Minimum Prices (same number order as search terms)", "type": "array", "description": "List the minimum prices for your search terms, matching the order exactly. For example, if your search terms are 'iPhone', 'PS5', and you want $50 for iPhone and $100 for PS5, enter '50', '100'. ⚠️ The first price is for the first search term, the second price is for the second, and so on.", "items": { "type": "string" } }, "maxPrices": { "title": "Maximum Prices (same number order as search terms)", "type": "array", "description": "List the maximum prices for your search terms, matching the order exactly. For example, if your search terms are 'iPhone', 'PS5', and you want $50 for iPhone and $100 for PS5, enter '50', '100'. ⚠️ The first price is for the first search term, the second price is for the second, and so on.", "items": { "type": "string" } }, "daysListed": { "title": "Days Since Listed (same number order as search terms)", "type": "array", "description": "List the days since listed for your search terms, matching the order exactly. For example, if your search terms are 'iPhone', 'PS5', and you want 7 days for iPhone and 30 days for PS5, enter '7', '30'. ⚠️ The first number is for the first search term, the second number is for the second, and so on.", "items": { "type": "string" } }, "searchRadii": { "title": "Search Radius (can make searches take longer) (same number order as search terms)", "type": "array", "description": "Optional: Enter a search radius for each term. Max allowed is 130 km (higher values will be automatically capped). If you leave this blank or enter fewer radii than search terms, those specific searches will search everywhere with no distance limits.", "items": { "type": "string" } }, "latitude": { "title": "Latitude (go to latlong.net to find!)", "type": "string", "description": "The latitude coordinate for the search location (e.g., '40.7128'). Can be negative, so make sure you get them right! You can find it with a quick Google search of where you live." }, "longitude": { "title": "Longitude (go to latlong.net to find!)", "type": "string", "description": "The longitude coordinate for the search location (e.g., '-74.00608'). Can be negative, so make sure you get them right! You can find it with a quick Google search of where you live." }, "filterKeywords": { "title": "Filter by Keywords", "type": "array", "description": "Only listings containing one or more of these keywords in the title will be saved and/or sent to Discord.", "items": { "type": "string" } }, "discordWebhook": { "title": "Discord Webhook URL", "type": "string", "description": "Paste your Discord webhook URL here to receive notifications for each found listing. Notifications are already designed for you." }, "listingsPerSearch": { "title": "Number of Listings to Find Per Search Term", "minimum": 1, "type": "integer", "description": "Maximum number of listings to scrape per search term." }, "useDeduplication": { "title": "Deduplicate Across Runs", "type": "boolean", "description": "Enable deduplication using processed listings file. Never be sent back a listing that's been found before.", "default": true }, "pushToDataset": { "title": "Export Listings to JSON (⚠️ Costs More)", "type": "boolean", "description": "Output to dataset. Auto-enabled if Discord webhook is disabled to ensure you get results.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration (Select residential, keep it as 'Anywhere')", "type": "object", "description": "Select proxies to use for the scraper. Apify Proxy is recommended." } } }, "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 } } } } } } } } } } ```