# Facebook Marketplace Seller Scraper: Profile & Inventory (`unitbytes/facebook-marketplace-seller-scraper`) Actor Extract Facebook Marketplace seller profiles (join date, star ratings, review counts, vanity URLs), detect undisclosed car dealers, real estate brokers & flippers, and discover active & recently sold listings starting from any Marketplace Item URL or ID. - **URL**: https://apify.com/unitbytes/facebook-marketplace-seller-scraper.md - **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community) - **Categories:** E-commerce, Lead generation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $40.00 / 1,000 seller inventory listing extracteds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Facebook Marketplace Seller Profile & Inventory Scraper Extract **Facebook Marketplace seller profiles**, **star ratings**, **exact account creation dates**, **undisclosed dealer / broker classifications**, and **active + recently sold listing catalogs** starting from any Facebook Marketplace Item URL or Item ID. > **Support, Custom Enhancements & Feedback**: Reach out anytime at **** for support, feature requests, custom data integrations, or enterprise volume inquiries. *** ### What Problems Does This Tool Solve? When sourcing cars, homes, rentals, or high-value goods on Facebook Marketplace, a single listing page only tells half the story: 1. **Disguised Car Dealers ("Curbstoners") Posing as Private Owners**: Unlicensed car flippers and commercial auto lots frequently post under personal Facebook accounts (`vehicle_seller_type: "PRIVATE_SELLER"`) so buyers and dealership acquisition teams think they are buying a personal car from its original owner — when the seller actually has dozens of vehicles listed across their profile. 2. **Undisclosed Real Estate Brokers & Agents Posing as Direct Homeowners**: Buyers and renters searching for **direct-from-owner ("For Sale By Owner" / direct landlord)** homes, apartments, and land frequently waste time contacting listings that appear to be private owners, only to discover the poster is a leasing agent or property broker managing a large portfolio. 3. **Distinguishing Moving Sales from Commercial Dealers**: Provides clear `inferred_seller_tier` (`PRIVATE_INDIVIDUAL`, `MULTI_ITEM_FLIPPER`, `HIGH_VOLUME_DEALER`) and `is_undisclosed_dealer` (`true` / `false`) output fields so direct homeowners or private car sellers having a household moving sale are separated from commercial dealers and brokers. 4. **Consolidated Seller Catalog & Sold History**: Instead of manually inspecting profiles one by one, you can provide any single listing URL or ID and receive the seller's **active catalog (`active_listings`)** and **recently sold listings (`sold_listings`)** in one structured output. *** ### Common Use Cases - **Direct-from-Owner Real Estate & Property Sourcing**: Distinguish **direct homeowners and landlords** (`PRIVATE_INDIVIDUAL`, `is_undisclosed_dealer: false`) from undisclosed real estate agents, property managers, and land brokers (`HIGH_VOLUME_DEALER`, `is_undisclosed_dealer: true`) — or audit a brokerage agent's active and leased properties from a single listing link. - **Automotive Dealership Acquisition & Curbstoner Filtering**: Focus your acquisition team on genuine private-party vehicles (`PRIVATE_INDIVIDUAL`) by filtering out curbstoners and commercial car flippers (`is_undisclosed_dealer: true`), or track competing dealerships' active lots and recently sold vehicles (`sold_listings`). - **Competitor Dealer & Reseller Inventory Tracking**: Starting from a single listing URL, extract up to 100 active and recently sold listings belonging to that seller, including current prices, strikethrough markdowns (`original_price`), mileage/subtitles, and availability status. - **Seller Due Diligence, Trust & Fraud Prevention**: Check account creation date (`join_date_iso`), 5-star seller rating (`seller_rating`, `seller_review_count`), combined buyer/seller rating (`combined_rating`), and personal profile URL (`personal_vanity_url`) before high-value transactions. - **Local E-Commerce & Liquidation Intelligence**: Monitor inventory velocity, pricing (`numeric_price`), and sold turnover for electronics resellers, furniture liquidators, and equipment dealers. *** ### Output Fields From any input listing URL or ID (`https://www.facebook.com/marketplace/item//`), the Actor outputs the following structured seller profile and inventory fields: 1. **Seller Profile & Trust Signals** - `seller_id` & `marketplace_user_profile_id` — Unique seller and commerce profile identifiers - `seller_name` — Seller display name - `join_time`, `join_date_iso`, & `join_year` — Exact Unix timestamp and UTC date (`YYYY-MM-DD`) the seller account was created on Facebook - `seller_rating` & `seller_review_count` — Seller-specific 5-star rating average and total seller reviews (when publicly displayed) - `combined_rating` & `combined_review_count` — Overall combined buyer + seller rating average and review count (when publicly displayed) - `marketplace_profile_url` — Direct link to the seller's Marketplace profile - `personal_vanity_url` & `personal_vanity_handle` — Personal Facebook profile URL (`https://www.facebook.com//`) when publicly available - `seller_avatar_url` — Seller profile picture URL - `city_display_name`, `primary_city`, & `primary_state` — Primary market location 2. **Dealer, Broker & Flipper Classification Fields** - `inferred_seller_tier`: - `HIGH_VOLUME_DEALER` — High-volume auto dealers, real estate brokers/property managers, or commercial liquidators - `MULTI_ITEM_FLIPPER` — Part-time vehicle flippers, multi-property landlords, or repeat resellers - `PRIVATE_INDIVIDUAL` — Direct private car owners, direct homeowners/landlords, or casual individuals - `is_undisclosed_dealer` — Boolean indicator (`true` / `false`) for commercial car curbstoners, unbadged real estate brokers, and high-volume resellers operating under personal accounts - `vehicle_seller_type`, `dealership_name`, `is_seller_business_onboarded`, & `should_show_business_seller_label` — Official commercial account flags 3. **Active & Recently Sold Inventory Fields** - `active_listings` & `sold_listings` — Arrays of active and recently sold items from the seller's catalog - Every listing object includes `item_id`, `url`, `title`, `price`, `numeric_price`, `original_price`, `status` (`ACTIVE`, `SOLD`, `PENDING`), `city`, `state`, `image_url`, `subtitles` (e.g., vehicle mileage), `seller_id`, and `is_seed_item` - **Single Charge Per Seller Per Run** — If your input list contains multiple item URLs from the same seller, that seller's output record is returned and billed only once. *** ### Input Parameters | Parameter | Type | Default | Description | | :--- | :---: | :---: | :--- | | `start_urls` | `array` | Prefilled | One or more Facebook Marketplace Item URLs (`https://www.facebook.com/marketplace/item//`). | | `item_ids` | `array` | Optional | Optional list of numeric Facebook Marketplace Item IDs (`164026455XXXXXX`) or Item URLs. | | `include_sold` | `boolean` | `true` | Include recently sold / out-of-stock listings belonging to each seller. | | `deep_pagination` | `boolean` | `true` | Enable extended catalog discovery to extract up to `100` listings for high-volume dealers and brokers. | | `max_items_per_seller` | `integer` | `100` | Maximum number of listings (`active + sold`) to return per seller (`1–100`). | #### Sample Input ```json { "start_urls": [ { "url": "https://www.facebook.com/marketplace/item/164026455XXXXXX/" } ], "include_sold": true, "deep_pagination": true, "max_items_per_seller": 100 } ``` *** ### Sample Output (Masked) Each dataset item represents one unique seller profile with summary fields at the top level (for one-click CSV/Excel export and the Apify Dataset Table view) plus nested `seller`, `active_listings`, and `sold_listings` objects: ```json { "seed_item_id": "164026455XXXXXX", "seed_item_url": "https://www.facebook.com/marketplace/item/164026455XXXXXX/", "seller_id": "100000807XXXXXX", "seller_name": "Alex M. [Masked]", "inferred_seller_tier": "HIGH_VOLUME_DEALER", "is_undisclosed_dealer": true, "active_listings_count": 46, "sold_listings_count": 9, "total_listings_count": 55, "join_date_iso": "2010-03-02", "seller_rating": 3.9, "seller_review_count": 21, "combined_rating": 4.0, "combined_review_count": 22, "personal_vanity_url": "https://www.facebook.com/alex.m.masked/", "marketplace_profile_url": "https://www.facebook.com/marketplace/profile/100000807XXXXXX/", "city_display_name": "Hempstead, NY", "seller": { "seller_id": "100000807XXXXXX", "marketplace_user_profile_id": "146716534XXXXXX", "seller_name": "Alex M. [Masked]", "join_time": 1267490749, "join_date_iso": "2010-03-02", "join_year": 2010, "seller_rating": 3.9, "seller_review_count": 21, "combined_rating": 4.0, "combined_review_count": 22, "seller_ratings_are_private": false, "marketplace_profile_url": "https://www.facebook.com/marketplace/profile/100000807XXXXXX/", "personal_vanity_url": "https://www.facebook.com/alex.m.masked/", "personal_vanity_handle": "alex.m.masked", "seller_avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/masked_avatar_160x160.jpg", "primary_city": "Hempstead", "primary_state": "NY", "city_display_name": "Hempstead, NY", "is_seller_business_onboarded": false, "should_show_business_seller_label": false, "vehicle_seller_type": "PRIVATE_SELLER", "dealership_name": null, "inferred_seller_tier": "HIGH_VOLUME_DEALER", "is_undisclosed_dealer": true }, "active_listings": [ { "item_id": "164026455XXXXXX", "url": "https://www.facebook.com/marketplace/item/164026455XXXXXX/", "title": "2026 BMW X3 xDrive", "price": "$43,374", "numeric_price": 43374.0, "original_price": null, "status": "ACTIVE", "is_live": true, "is_sold": false, "is_pending": false, "city": "Hempstead", "state": "NY", "image_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/masked_listing_active_1.jpg", "subtitles": [ "21K miles" ], "seller_id": "100000807XXXXXX", "is_seed_item": true } ], "sold_listings": [ { "item_id": "161709995XXXXXX", "url": "https://www.facebook.com/marketplace/item/161709995XXXXXX/", "title": "2012 Ford Escape XLT", "price": "$4,600", "numeric_price": 4600.0, "original_price": "$5,200", "status": "SOLD", "is_live": false, "is_sold": true, "is_pending": false, "city": "Massapequa Park", "state": "NY", "image_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/masked_listing_sold_1.jpg", "subtitles": [ "118K miles" ], "seller_id": "100000807XXXXXX", "is_seed_item": false } ] } ``` *** ### Data Coverage, Accuracy & Realistic Limitations We believe in strict transparency so you know exactly what to expect before integrating this tool into your workflow. **We do not guarantee 100% extraction of every listing or profile field on Facebook Marketplace.** | Data Category / Output Fields | Observed Fill / Accuracy Rate | Important Notes & Realistic Limitations | | :--- | :---: | :--- | | **Seller Identity & Join Date** (`seller_id`, `seller_name`, `join_date_iso`, `marketplace_profile_url`) | **~98–100%** (on active items) | Returned whenever the input listing is active and publicly accessible on Facebook Marketplace. Deleted, expired, or unavailable listings return an error. | | **Listing Card Fields** (`item_id`, `url`, `title`, `price`, `numeric_price`, `status`, `city`, `image_url`) | **~98–100%** | Populated for each item inside `active_listings` and `sold_listings`. Optional fields like `original_price` (strikethrough price) and `subtitles` are populated when present on the listing. | | **Active & Sold Inventory Completeness** (`active_listings`, `sold_listings`) | **~75–95% typical coverage** *(Not guaranteed 100% exhaustive)* | **We do not guarantee that 100% of a seller's active or sold listings will be returned.** While the output typically includes 75%–95% of a seller's active inventory (up to `100` listings per seller) and recently sold items, some active or historical listings may not be returned depending on platform visibility and listing availability at the time of the run. | | **Dealer / Broker / Flipper Classification** (`inferred_seller_tier`, `is_undisclosed_dealer`) | **~85–92%** | Automated classification fields — not official government or legal licensing records. We do not guarantee 100% classification accuracy in every case. | | **Seller Star Ratings & Review Counts** (`seller_rating`, `seller_review_count`, `combined_rating`) | **100% when public** *(~50–65% of sellers overall)* | Populated whenever public star ratings are displayed on the seller's profile. Returns `null` if the seller has not yet received enough ratings to display a public score or has set ratings to private (`seller_ratings_are_private: true`). | | **Personal Profile URL** (`personal_vanity_url`, `personal_vanity_handle`) | **~55–65% of sellers** | Populated when a public profile handle is available for the account (`null` otherwise). | #### Additional Scope Notes - **Input Format**: Provide any Facebook Marketplace **Item URL** (`https://www.facebook.com/marketplace/item//`) or numeric **Item ID**. - **Up to 100 Listings Per Seller**: Returns up to `100` listings (`active + recently sold`) per seller (`max_items_per_seller: 1–100`), with your input listing included at index `0` (`is_seed_item: true`). You are only billed for the exact number of listings returned. - **Rating Aggregates Only**: Outputs 5-star rating averages and review counts (`seller_rating`, `combined_rating`), not individual written buyer review text comments. *** ### Pricing, Support & Custom Enhancements - **Pay-Per-Event (PPE) Pricing**: - **Seller Inventory Listing Extracted (`search-item`)**: `$0.04` per listing (`$40.00 / 1,000` listings). - **Actor Start (`apify-actor-start`)**: `$0.05` per run start. - You can strictly cap your spend on any run using Apify's **Maximum cost per run** setting or the `max_items_per_seller` input parameter. - **Paid Apify Plan Required**: A [paid Apify subscription plan](https://apify.com/pricing) is required to run this Actor. - **Support, Enhancements & Feedback**: - Email us directly at **** for support, custom feature requests, higher volume limits, or feedback, or open a ticket in the Actor's **Issues** tab on Apify Console. *** ### More Local Marketplace, Vehicle & Real Estate Scrapers
⚡ UnitBytes · Local Marketplaces, Vehicles, Real Estate & Classifieds Ecosystem
👤 FB Marketplace Seller Scraper
📍 You are here
Seller profiles, dealer/broker detection & active + sold catalogs 		🏷️ Craigslist All-in-One
700+ Cities · All Categories
Cars, housing, jobs, for sale, phones & emails 		📱 OfferUp All-in-One
Local Deals, Motors & Shipping
ZIP radius, 19 vehicle specs, seller leads & price drops
🛒 FB Marketplace All-in-One
50+ Fields · Multi-City Search
Search vehicles, rentals & local deals across any city or ZIP 		🚗 Craigslist Cars & Vehicles
By Owner (CTO), VIN & Miles
17-digit VIN, clean title, RVs, boats & motorcycles 		🚙 OfferUp Used Cars & VIN
Dealer Specs & History Issues
VIN, MPG, drivetrain & Carfax/AutoCheck issue counts
🏎️ FB Marketplace Vehicles
Cars, Trucks & Motorcycles
Filter by make, model, year, odometer mileage & VIN 		🏠 Craigslist Real Estate (FSBO)
Apartments, Rentals & Homes
Beds, baths, sqft, pets, parking, sublets & FSBO leads 		🏪 OfferUp Seller & Dealer Leads
Storefronts & B2B Contacts
Full /p/<userId> catalog, dealer phones, address & reviews
🏢 FB Marketplace Property
Rentals & Homes for Sale
Beds, baths, sqft, pet policy, walk scores & landlords 		💼 Craigslist Jobs & Gigs
35+ Job Sectors & Services
Compensation, remote/telecommute, paid gigs & contractors 		⚡ OfferUp Deal & Price Monitor
Price Drops & Status Tracker
Fresh bargains, % price drops & batch LISTED/SOLD check
🔍 FB Marketplace Status Checker — Bulk audit listing availability (ACTIVE / SOLD / PENDING / REMOVED) & markdown price drops across existing URLs.
# Actor input Schema ## `start_urls` (type: `array`): Paste one or more Facebook Marketplace Item URLs (e.g. https://www.facebook.com/marketplace/item/1640264554118295/) from the target seller(s) to extract their complete seller profile, star ratings, join date, dealer/curbstoner classification, and full active + recently sold inventory. ## `item_ids` (type: `array`): Optional list of numeric Facebook Marketplace Item IDs (e.g. 1640264554118295) or Item URLs. ## `include_sold` (type: `boolean`): Also discover recently sold / out-of-stock listings belonging to each seller. ## `deep_pagination` (type: `boolean`): Enable extended catalog discovery to extract up to 100 active and recently sold listings for high-volume dealerships, brokers, and resellers. ## `max_items_per_seller` (type: `integer`): Maximum number of listings (active + sold) to return per seller (1-100). ## Actor input object example ```json { "start_urls": [ { "url": "https://www.facebook.com/marketplace/item/1640264554118295/" } ], "include_sold": true, "deep_pagination": true, "max_items_per_seller": 100 } ``` # Actor output Schema ## `results` (type: `string`): Complete seller profile metadata, star ratings, join dates, dealer/flipper classifications, and active + sold listing catalogs. # 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 = { "start_urls": [ { "url": "https://www.facebook.com/marketplace/item/1640264554118295/" } ], "include_sold": true, "deep_pagination": true, "max_items_per_seller": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("unitbytes/facebook-marketplace-seller-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 = { "start_urls": [{ "url": "https://www.facebook.com/marketplace/item/1640264554118295/" }], "include_sold": True, "deep_pagination": True, "max_items_per_seller": 100, } # Run the Actor and wait for it to finish run = client.actor("unitbytes/facebook-marketplace-seller-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "start_urls": [ { "url": "https://www.facebook.com/marketplace/item/1640264554118295/" } ], "include_sold": true, "deep_pagination": true, "max_items_per_seller": 100 }' | apify call unitbytes/facebook-marketplace-seller-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/facebook-marketplace-seller-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/hTCybnyWbKEn1Mq33/builds/hpa7KkcHTPQfE4jc1/openapi.json