# Facebook Marketplace Scraper (`scrapers-hub/facebook-marketplace-scraper`) Actor πŸš€ facebook-marketplace-scraper extracts listings data from Facebook Marketplace fast and reliably. 🏷️ Great for research, lead gen, and price analysis. πŸ“ˆ Clean, structured resultsβ€”ideal for teams. Try it today! - **URL**: https://apify.com/scrapers-hub/facebook-marketplace-scraper.md - **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results 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 Scraper: The Ultimate Manual for Local E-commerce Intelligence In the rapidly evolving landscape of 2026, real-time data from local economies has become a cornerstone for businesses, resellers, and market analysts. The Facebook Marketplace Scraper is a professional-grade, high-performance data extraction tool engineered to navigate the complex web architecture of Facebook to gather local listings and seller insights. By transforming public marketplace search results into structured, actionable data, the Facebook Marketplace Scraper enables you to monitor price trends, track inventory fluctuations, and conduct localized market research at an unprecedented scale. πŸ“ˆ Unlike traditional, slow manual browsing, the Facebook Marketplace Scraper empowers you to aggregate thousands of listings across multiple cities in seconds. This documentation explores the architecture, strategic advantages, technical optimization, and ethical considerations of using the Facebook Marketplace Scraper to dominate the local secondhand and retail markets. 🌐 #### πŸ—οΈ 1. Technical Architecture of the Facebook Marketplace Scraper The Facebook Marketplace Scraper is built on a resilient framework designed to handle the dynamic, JavaScript-heavy nature of modern social commerce platforms. At its core, the Facebook Marketplace Scraper functions as a sophisticated browser automation engine that interprets and extracts data directly from the Document Object Model (DOM) without the need for an official API. #### βš™οΈ Automation Configuration (Input Parameter Guide) 🎨 Target Selection – Define the specific city IDs and search queries you want the Facebook Marketplace Scraper to focus on. πŸ”’ Volume Control – Use the MAX_ITEMS parameter to tell the Facebook Marketplace Scraper exactly how many listings to retrieve per run. πŸ•’ Scroll & Render Logic – The Facebook Marketplace Scraper uses intelligent delays to ensure that all high-resolution images and pricing details are fully rendered before extraction. πŸ”— Deep Link Support – The Facebook Marketplace Scraper supports full browser URLs, including complex filters for price range, condition, and category. ### πŸ“₯ Input Format Your scraper accepts a simple JSON configuration to define the scope of the search: ```json { "target_url": "https://web.facebook.com/marketplace/101889586519301/search?query=cricket%20bat", "MAX_ITEMS": 100 } ```` ### πŸ“€ Output Structure The scraper delivers detailed objects for every listing found. Below is an example of the structured data you will receive: ```json { "city": "ΰ¦•ΰ§‡ΰ¦°ΰ¦Ύΰ¦¨ΰ§€ΰ¦—ΰ¦žΰ§ΰ¦œ", "city_page_name": "Malancha, Dhaka, Bangladesh", "marketplace_listing_title": "Cricket bat new balance", "formatted_amount": "BDT1,300", "amount": "1300.00", "primary_image_uri": "https://z-p3-scontent.fdac3-1.fna.fbcdn.net/...", "is_live": true, "is_pending": false, "location_city_page_id": "111629518864993", "story_key": "25962302920073234" } ``` #### 🌟 2. Key Features of the Facebook Marketplace Scraper The Facebook Marketplace Scraper comes with a specialized feature set that makes it a leader in the local e-commerce intelligence space: πŸ”’ No Authentication Required – The Facebook Marketplace Scraper operates entirely on public listings, protecting your personal account from risk. πŸ“ Localized Scraping – Extract data based on specific city IDs (e.g., Dhaka, Keraniganj) with the Facebook Marketplace Scraper. πŸ’° Comprehensive Pricing – Captures formatted amounts (e.g., BDT), raw sale prices, and original strikethrough prices. πŸ–ΌοΈ Visual Data Extraction – The Facebook Marketplace Scraper provides direct links to high-quality listing images and video metadata. πŸ›‘ Status Tracking – Instantly identify if a listing is Live, Pending, or Sold using the Facebook Marketplace Scraper. ⚑ Lightning Fast Execution – Optimized to bypass unnecessary page elements to ensure the Facebook Marketplace Scraper retrieves data at high speeds. πŸ“Š Universal Export Formats – Download results from the Facebook Marketplace Scraper in JSON, CSV, or Excel (XLSX). πŸ›‘οΈ 3. The "No-Login" Security Protocol of the Facebook Marketplace Scraper Security and account safety are paramount when dealing with large-scale data extraction. The Facebook Marketplace Scraper is designed with a "Privacy-First" approach. πŸ‘€ Anonymous Guest Browsing – The Facebook Marketplace Scraper acts as a guest visitor, leaving no trace of your identity or personal browsing history. 🚫 Zero Account Risk – By not requiring a login, the Facebook Marketplace Scraper ensures your main Facebook profile is never flagged for automated activity. 🌍 Bypassing Region Blocks – The Facebook Marketplace Scraper can use global proxies to see listings in cities you are not physically located in. πŸ›‘οΈ Stealth Fingerprinting – Sophisticated header rotation ensures the Facebook Marketplace Scraper stays undetected by anti-bot measures. #### πŸ“Š 4. Data Extraction Capabilities (Detailed Schema Mapping) The Facebook Marketplace Scraper provides a 360-degree view of the local market. Below is the mapping of data fields provided by the Facebook Marketplace Scraper: | Data Field | Type | Description | | ------------------------- | ------- | -------------------------------------------------------------------- | | marketplace\_listing\_title | String | The official title of the item being sold. | | formatted\_amount | String | Price as displayed (e.g., BDT 1,300). | | amount | Float | Raw numerical value for price calculations. | | city | String | Local name of the city (e.g., ΰ¦•ΰ§‡ΰ¦°ΰ¦Ύΰ¦¨ΰ§€ΰ¦—ΰ¦žΰ§ΰ¦œ). | | primary\_image\_uri | URL | Direct link to the listing’s high-resolution image. | | is\_live | Boolean | Real-time status indicating whether the item is currently available. | | story\_key | ID | A unique identifier captured by the Facebook Marketplace Scraper. | #### πŸ“ˆ 5. Strategic Industry Use Cases for the Facebook Marketplace Scraper How can you leverage the Facebook Marketplace Scraper to gain a competitive advantage? 🎯 Retail Arbitrage – Use the Facebook Marketplace Scraper to find undervalued electronics or furniture in one city and flip them for a profit in another. πŸ“Š Price Monitoring – Track the average market value of items like "Cricket Bats" or "Smartphones" using the Facebook Marketplace Scraper. πŸš€ Lead Generation – Identify high-volume sellers and power-users in specific neighborhoods with the Facebook Marketplace Scraper. πŸ“‰ Trend Analysis – Aggregate data from the Facebook Marketplace Scraper to see which brands are currently trending in the secondhand market. 🏒 Real Estate Research – Monitor local rental and property listings to identify emerging investment hotspots via the Facebook Marketplace Scraper. 🚚 Logistics Optimization – Analyze delivery types and availability in specific regions using the Facebook Marketplace Scraper. #### πŸ› οΈ 6. Advanced Technical Workflows for Facebook Marketplace Scraper The Facebook Marketplace Scraper is most powerful when it acts as the starting point for a larger automation ecosystem. πŸ”„ Real-Time Price Alerts – Integrate the Facebook Marketplace Scraper with a webhook. If an item drops below a certain price, get an instant notification on Discord or Telegram. πŸ€– AI-Driven Valuation – Feed the titles and prices extracted by the Facebook Review Scraper and Facebook Marketplace Scraper into an AI model to estimate the "Fair Market Value" of used goods. πŸ“Š Geographic Heat-Maps – Use the city and location data from the Facebook Marketplace Scraper to create a visual heat map showing product availability across Bangladesh or any global region. #### 🧠 7. Unique Competitive Intelligence Strategies Beyond basic scraping, the Facebook Marketplace Scraper allows for advanced market manipulation and monitoring: Competitor Inventory Tracking: Run the Facebook Marketplace Scraper daily to see how fast a specific competitor is selling their items. If their listings disappear within hours, you know there is high demand. Keyword Gap Analysis: Use the Facebook Marketplace Scraper to find what items are missing from a local market. If "Cricket Helmets" are searched but not found by the Facebook Marketplace Scraper, there is a gap you can fill. Seasonal Demand Prediction: Analyze historical data collected by the Facebook Marketplace Scraper to predict when winter clothing or sports equipment will peak in price. #### πŸ›‘οΈ 8. Advanced Anti-Detection & Scalability The Facebook Marketplace Scraper is engineered to stay ahead of sophisticated security measures. 🎭 User-Agent Spoofing – The Facebook Marketplace Scraper constantly changes its digital fingerprint, mimicking iPhones, tablets, and various desktop browsers. 🌍 Residential Proxy Rotation – Pair the Facebook Marketplace Scraper with residential proxies to bypass IP-based rate limits and scrape thousands of listings effortlessly. ⏳ Adaptive Request Throttling – The Facebook Marketplace Scraper uses "jitter" logic to randomize request timing, appearing completely human to monitoring scripts. #### ❓ 9. Frequently Asked Questions (FAQ) 🏒 Can I scrape listings from multiple cities at once? Yes. By providing multiple URLs or using the Facebook Marketplace Scraper's city-page ID feature, you can aggregate global data. πŸ“… How accurate is the pricing data? The Facebook Marketplace Scraper pulls the exact values visible on the screen, including the raw amount and the formatted\_amount for 100% accuracy. ♾️ Is there a limit to how many items I can pull? The Facebook Marketplace Scraper has no hard limit, though we recommend using residential proxies for tasks exceeding 1,000 items. πŸ“‚ What formats are available? Results from the Facebook Marketplace Scraper are available in JSON, CSV, and Excel (XLSX). #### πŸ›‘οΈ 10. Ethical Standards and Legal Compliance Using the Facebook Marketplace Scraper comes with a commitment to responsible and ethical data usage. βš–οΈ πŸ›οΈ Respecting Public Information – The Facebook Marketplace Scraper only accesses information that users have intentionally shared in the public domain. 🚦 Rate Limit Adherence – The Facebook Marketplace Scraper includes built-in delays to ensure it remains a "considerate visitor" on the web. βš–οΈ Privacy Protection – The Facebook Marketplace Scraper does not collect private phone numbers, home addresses, or hidden seller data. 🀝 Transparency Focus – This tool is built to increase market transparency and help local economies thrive through data accessibility. #### πŸ“Š 11. Data Enrichment API Mapping Table For developers looking to integrate the Facebook Marketplace Scraper with external BI tools: | Feature | Enrichment Source | Purpose with Facebook Marketplace Scraper | | ----------------- | ----------------- | --------------------------------------------------------------------------------------------- | | Market Value | eBay / Amazon API | Compare Facebook Marketplace Scraper prices with global retail listings. | | Geo-Coding | Mapbox API | Convert city data from the Facebook Marketplace Scraper into GPS coordinates. | | Condition Grading | AI Image Analysis | Automatically estimate item condition using the `primary_image_uri`. | | Lead Scoring | Internal CRM | Identify whether a seller found by the Facebook Marketplace Scraper is a high-value prospect. | #### 🏁 12. Conclusion: Dominate Your Local Market The world of 2026 is driven by real-time intelligence. The Facebook Marketplace Scraper is the ultimate bridge between disorganized local listings and clear, strategic business insights. It eliminates the manual work of searching and replaces it with a streamlined, automated, and intelligent data pipeline. 🌟 Whether you are a startup looking for your first 1,000 leads, a reseller looking for the best margins, or an agency building a regional price index, the Facebook Marketplace Scraper is your most reliable partner. By choosing the Facebook Marketplace Scraper, you are investing in a scalable data strategy that will serve your business for years to come. πŸš€πŸ“ˆ #### πŸš€ Get Started with the Facebook Marketplace Scraper Today! Are you ready to revolutionize the way you gather local market data? The Facebook Marketplace Scraper is waiting for your first command. If you need a custom configuration for the Facebook Marketplace Scraper or want to integrate it with your existing data stack, our team is here to support you every step of the way! 🀝 # Actor input Schema ## `target_url` (type: `string`): The Facebook Marketplace URL to scrape (e.g., search results or category page). ## `MAX_ITEMS` (type: `integer`): Maximum number of items to fetch. ## `includeListingDetails` (type: `boolean`): If enabled, the scraper visits each listing's detail page to collect full details (complete description, all photos, exact location, condition/attributes, posted time, etc.). Slower, but much richer data. ## Actor input object example ```json { "target_url": "https://web.facebook.com/marketplace/101889586519301/search?query=cricket%20bat", "MAX_ITEMS": 100, "includeListingDetails": false } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("scrapers-hub/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 = {} # Run the Actor and wait for it to finish run = client.actor("scrapers-hub/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 '{}' | apify call scrapers-hub/facebook-marketplace-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapers-hub/facebook-marketplace-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper", "description": "πŸš€ facebook-marketplace-scraper extracts listings data from Facebook Marketplace fast and reliably. 🏷️ Great for research, lead gen, and price analysis. πŸ“ˆ Clean, structured resultsβ€”ideal for teams. Try it today!", "version": "1.0", "x-build-id": "dSWSEktyMxZ7omdbA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~facebook-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-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/scrapers-hub~facebook-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-scrapers-hub-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/scrapers-hub~facebook-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-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": [ "target_url" ], "properties": { "target_url": { "title": "Target URL", "type": "string", "description": "The Facebook Marketplace URL to scrape (e.g., search results or category page).", "default": "https://web.facebook.com/marketplace/101889586519301/search?query=cricket%20bat" }, "MAX_ITEMS": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of items to fetch.", "default": 100 }, "includeListingDetails": { "title": "Include listing details", "type": "boolean", "description": "If enabled, the scraper visits each listing's detail page to collect full details (complete description, all photos, exact location, condition/attributes, posted time, etc.). Slower, but much richer data.", "default": false } } }, "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 } } } } } } } } } } ```