Tsutsei Software
Facebook Marketplace Scraper icon

Facebook Marketplace Scraper

Any town or ZIP code, a radius that holds, no login

This Facebook Marketplace scraper searches listings by keyword around any town, postal code or coordinates and returns them as clean rows, without a login or cookies. The catch with Marketplace is the radius: Facebook often ignores it and mixes in listings from far away. In a 20 km search around Ostrava we got listings from 140 and 280 km. The actor measures the distance of every listing and drops what is outside your radius, and you are not charged for those.

Try it on Apify Store See examples

Countries
ALL
Output
JSON · CSV · Excel · API
Monitoring
New and changed only
Updated

tsutseisoftware/facebook-marketplace-scraperdataset · item 1

title"iPhone 15 PRO"
price10900
currency"CZK"
priceText"CZK10,900"
priceUsd497.96
isFreefalse
city"Ostrava"
locationName"Ostrava, Czech Republic"

One row per ad. Download as JSON, CSV or Excel, or read it through the API.

Overview

What you get from Facebook Marketplace

Locations are written the way people say them: "Austin, TX, US", "70200, CZ", "SW1A, GB" or plain coordinates. When a town name exists in several countries, such as Cambridge, the run stops and asks for the country instead of guessing, and it never quietly falls back to San Francisco. The radius can be in km or miles. For a bigger area, Cover the whole radius covers the whole circle, up to 500 km, without duplicates.

Every row has the title, price and currency, Facebook's own USD value, the town, the distance in km and miles, a photo, the seller's name and ID, and the date. Listing details add the description, all photos, the location rounded to the neighbourhood, condition, shipping, and for vehicles the make, model, mileage, fuel, owners and VIN. Next to Facebook's own filters (price, condition, date listed, pickup or shipping, 17 categories) the actor has its own: words the title must or must not contain, posted in the last N hours, only reduced items, placeholder prices out, repeated posts of one seller out. You can also search sold listings to see what items really went for.

There is no login and no cookies, and e-mails and phone numbers are removed from titles and descriptions. The seller's public profile name and ID are on every row, though, and that is personal data: use it lawfully (GDPR in the EU). The seller's profile photo is an opt-in add-on.

In detail

Deal score, price drops and new listing alerts

Each listing is compared with similar listings of the same search, so "iPhone 13" is not compared with "iPhone 13 case". You get the usual price, how far this one is below or above it in percent, and a deal score from 0 to 100. A filter like "at least 20 % below the usual price" turns a search into a list of real bargains.

For scheduled runs, monitoring returns only new listings and the ones whose price or status changed, with the previous price. You can ask for price drops only, and for listings sold or removed since the last run. Reposts are detected, and a run can stop at the first listing it already knows, which keeps checks every few minutes cheap. New items can go to Telegram, Slack, Discord or your own webhook. Every run also saves a free market summary with price quartiles, towns with the most listings and the share of sold and reduced items, and prices can be converted to any currency at daily ECB rates.

Features

Why use this Facebook Marketplace scraper

  • Search anywhere, the way people say it

    Use a town ("Ostrava", "Austin, TX, US", "Paris, France"), a postal code with its country ("70200, CZ", "10001, US", "SW1A, GB") or coordinates. When a town name exists in several countries ("Cambridge"), the run stops and asks for the country instead of guessing. It never falls back to San Francisco without telling you.

  • Strict radius in km or miles, free of charge

    Facebook does not keep to the radius; the actor measures every listing's distance from your location and leaves out the rest. For a radius over about 60 km (up to 500 km), turn on Cover the whole radius; duplicates are removed.

  • Deal score

    Every listing is compared with similar listings of the same search (same item, not its accessories, so "iPhone 13" is not compared with "iPhone 13 case"). You get the usual price (comparableMedianPrice), the difference in % (priceVsMedianPercent) and a dealScore from 0 to 100. Filter by "at least 20 % below the usual price" or by a minimum deal score.

  • All of Facebook's filters

    price from/to, condition, listed in the last 24 h / 7 / 30 days, local pickup or shipping, sort (newest, price, distance), exact match, 17 categories. You can also search sold listings, to see what items really sold for.

  • Vehicles

    vehicle type, body style, year from/to, mileage from/to, transmission. Details add make, model, trim, mileage, fuel, colours, owners, title status and VIN.

  • Filters Facebook doesn't have

    words the title (or description) must or must not contain, title must contain all search words, posted in the last N hours, posted between two dates, only reduced listings, only free items, placeholder and implausible prices out, duplicate posts of one seller out, excluded sellers or a seller watch-list, seller type, and your own rules on any field. Listings left out are not charged.

  • Monitoring for scheduled runs

    Only new listings and listings whose price or status changed come back, with the previous price and the change in %. You can ask for only price drops (optionally at least X %), and for listings that were sold or removed since the last run. Reposted listings are detected, and you can choose a silent first run and stop at known listings (cheap checks every few minutes).

  • Alerts

    Telegram, Slack, Discord, WhatsApp or your own webhook (Zapier, Make, n8n) after each run.

  • Free market summary

    (SUMMARY record): price quartiles by currency and condition, towns with most listings, shares of shipping, sold and reduced listings, how old and how far the listings are, for every search.

  • Prices in one currency

    Facebook's own USD price on every row, plus Convert prices to any currency (daily ECB rates).

  • Clean, flat output

    Named columns (title, price, currency, city, distanceKm, postedAt…) instead of Facebook's raw structure, ready for Excel and CSV. Choose compact output, chosen fields or no empty fields.

  • Seller

    name and ID on every row (Facebook hides the seller of sold listings). With details you also get the Marketplace profile link, rating and join date, and with the seller profile photo add-on the seller's profile picture.

  • No login, no cookies, no Facebook account

    E-mails and phone numbers (local and international formats) are removed from titles and descriptions.

Who uses it

Who uses the Facebook Marketplace scraper

  • Resellers and flippers

    Get an alert every 15 minutes when an item shows up at least 25 % under its usual price nearby.

  • Car buyers and dealers

    Search automatic SUVs from a given year and under a mileage limit, with make, model and VIN from the details.

  • Sellers and price researchers

    Search sold listings to learn what an item really sells for in their area, not just what people ask.

  • Market researchers

    Compare the same search across towns and countries, with prices in the local currency, in USD and in one currency of their choice.

  • Developers and AI agents

    Call it through the Apify API or MCP server with compact output or only the fields they need.

Output fields

What data can you get

GroupFields
Listingid, url, title, price, currency, priceText, priceUsd, originalPrice, discountPercent, isFree, postedAt, listingAgeHours, categoryName, status, isSold, isPending
Placecity, state, locationName, country, latitude, longitude, locationPrecision, distanceKm, distanceMiles, withinRadius
SellersellerName, sellerId; with details sellerProfileUrl, sellerRating, sellerRatingCount, sellerJoinedAt, sellerType; with the seller photo add-on sellerPhotoUrl
PhotosimageUrl; with details imageUrls (all), imageCount
Detailsdescription, condition, conditionLabel, attributes, deliveryTypes, shippingOffered, shippingPrice
VehiclesvehicleYear, vehicleMileage, vehicleMileageUnit; with details vehicleMake, vehicleModel, vehicleTrim, vehicleTransmission, vehicleFuelType, vehicleExteriorColor, vehicleInteriorColor, vehicleOwners, vehicleTitleStatus, vehicleVin, vehicleFeatures
DealcomparableCount, comparableMedianPrice, priceVsMedianPercent, dealScore, priceConverted, convertedCurrency
SearchsearchQuery, searchLocation, searchCategory, searchRadiusKm, searchUrl, position
MonitoringchangeType, changedFields, previousPrice, priceChange, priceChangePercent, firstSeenAt, removedAt, removedReason, isRepost, repostOf

Step by step

How to scrape Facebook Marketplace

  1. Enter Search keywords (e.g. iphone 13) and Locations (e.g. 70200, CZ or Ostrava, CZ).
  2. Set the Radius (km or miles) and, if you like, Facebook's filters and the actor's filters.
  3. Turn on Add listing details if you need descriptions, all photos and exact places.
  4. Click Start. Download the results as Excel, CSV or JSON, or get them through the API.
  5. For alerts, schedule the run (e.g. every 15 minutes), turn on Monitoring: only new or changed listings and add a Telegram, Slack, Discord or WhatsApp channel.

Try it on Apify Store

Examples

Ready-made inputs

Copy an input into the JSON tab of the actor in Apify Console and run it, or change it to your needs.

01Used iPhones within 20 km of a postal code

InputJSON

{
  "searchQueries": ["iphone 13", "iphone 14"],
  "locations": ["70200, CZ"],
  "radius": 20,
  "excludeKeywords": ["case", "kryt", "obal", "broken"],
  "maxItems": 200
}
02Deals: at least 25 % under the usual price, to Telegram every 15 minutes

InputJSON

{
  "searchQueries": ["ps5", "nintendo switch"],
  "locations": ["Austin, TX, US"],
  "radius": 30,
  "radiusUnit": "mi",
  "sortBy": "newest",
  "maxPriceVsMedianPercent": -25,
  "onlyNewOrChanged": true,
  "monitoringKey": "austin-consoles",
  "monitoringEarlyStop": true,
  "telegramBotToken": "123456:ABC...",
  "telegramChatId": "123456789"
}
03Cars: automatic SUVs from 2015, under 150 000 km, with details

InputJSON

{
  "categories": ["vehicles"],
  "locations": ["Munich, DE"],
  "radius": 50,
  "vehicleTypes": ["car_truck"],
  "bodyStyles": ["suv"],
  "vehicleMinYear": 2015,
  "vehicleMaxMileage": 150000,
  "vehicleTransmission": "automatic",
  "includeDetails": true,
  "maxItems": 100
}
04What things really sell for (sold listings)

The SUMMARY record then has the median and quartiles of the sold prices. Facebook returns pending (reserved) listings with the sold ones; they have isPending: true.

InputJSON

{
  "searchQueries": ["dyson v15"],
  "locations": ["London, GB"],
  "radius": 25,
  "availability": "sold",
  "maxItems": 300
}
05Price drops and sold items of a saved search

InputJSON

{
  "searchQueries": ["road bike"],
  "locations": ["Seattle, WA, US"],
  "radius": 15,
  "radiusUnit": "mi",
  "onlyNewOrChanged": true,
  "monitoringKey": "seattle-road-bikes",
  "onlyPriceDrops": true,
  "minPriceDropPercent": 10,
  "includeRemovedListings": true
}
06A whole region: radius up to 500 km

InputJSON

{
  "searchQueries": ["tractor"],
  "locations": ["Brno, CZ"],
  "radius": 150,
  "coverWholeRadius": true,
  "maxItems": 0
}
07A search copied from the browser, and single listings

When Facebook does not know the town in the URL (it would quietly search around San Francisco), the URL is skipped and the status says so: use Locations for that place.

InputJSON

{
  "startUrls": [
    { "url": "https://www.facebook.com/marketplace/berlin/search?query=fahrrad&maxPrice=200" },
    { "url": "https://www.facebook.com/marketplace/item/1156777293589139/" }
  ]
}

Output

Output example

Dataset itemJSON

{
  "id": "1156777293589139",
  "source": "facebook-marketplace",
  "url": "https://www.facebook.com/marketplace/item/1156777293589139/",
  "title": "iPhone 15 PRO",
  "price": 10900,
  "currency": "CZK",
  "priceText": "CZK10,900",
  "priceUsd": 497.96,
  "originalPrice": null,
  "isFree": false,
  "city": "Ostrava",
  "locationName": "Ostrava, Czech Republic",
  "country": "CZ",
  "latitude": 49.835,
  "longitude": 18.282,
  "locationPrecision": "town",
  "distanceKm": 1.7,
  "distanceMiles": 1.1,
  "withinRadius": true,
  "postedAt": "2026-11-11T17:58:56Z",
  "listingAgeHours": 2.8,
  "categoryName": "Electronics",
  "deliveryTypes": ["local_pickup"],
  "status": "available",
  "sellerName": "Example Seller",
  "sellerId": "pfbid02dRSo4PeD...",
  "imageUrl": "https://scontent.xx.fbcdn.net/v/t39.84726-6/...jpg",
  "comparableCount": 6,
  "comparableMedianPrice": 12000,
  "priceVsMedianPercent": -9.2,
  "dealScore": 55,
  "searchQuery": "iphone",
  "searchLocation": "Ostrava, Czechia",
  "searchRadiusKm": 20,
  "position": 1,
  "detailsIncluded": false,
  "scrapedAt": "2026-11-11T20:00:00Z"
}

API

For AI agents and API users

  • Call the actor with the input above through the Apify API, the Apify MCP server or any integration; results are in the default dataset, the market summary in the SUMMARY record of the key-value store.
  • For small answers use "compact": true or "fields": ["title", "price", "currency", "distanceKm", "url"], and "maxItems".
  • Input errors (an unknown town, a postal code without a country, a filter that needs details) end the run with a message that says what to change.

FAQ

Questions about the Facebook Marketplace Scraper

Is it legal to scrape Facebook Marketplace?

It reads only publicly available data that Facebook shows to any visitor without an account, without logging in or using cookies, at most 120 requests per minute, slows down when the website asks and never solves captchas or other challenges. A refused request is asked again from a new IP address only with Retry refused requests from a new IP address (on by default, charged as New IP retry). Listings include the seller's public profile name; you are responsible for processing such personal data lawfully (e.g. GDPR in the EU: a legitimate purpose, no spam, deletion on request). E-mails and phone numbers are removed from descriptions. The seller profile photo is an opt-in add-on; a photo of a person is personal data, so use it only where you have a lawful reason. This actor is not affiliated with Meta or Facebook.

How is it different from other Marketplace scrapers?

Many Marketplace scrapers have no postal code or radius input, quietly search around San Francisco when they don't know a place, or keep to the radius only with details.

Do I need a Facebook account or cookies?

No. Nothing is logged in.

Why are some listings outside my radius missing?

That is the strict radius: Facebook adds listings from far away and the actor leaves them out (free of charge). Turn off Strict radius to keep them with their distance.

How does it know where a postal code is?

Your postal code is sent to the public geocoders Zippopotam.us and OpenStreetMap Nominatim. Place data © GeoNames (CC BY 4.0).

Can I search in miles?

Yes, set Radius unit to miles. Every row has both distanceKm and distanceMiles.

Which countries work?

Every country where Facebook Marketplace is available. Prices come in the local currency. Facebook adds its own USD value on every row (priceUsd), and Convert prices to gives any currency.

Can I use it from an AI agent or through MCP?

Yes. The actor works with the Apify MCP server and API, and a small output (compact or chosen fields) keeps agent answers short.


More scrapers from the same developer: tsutseisoftware on Apify.

Also known as a Facebook Marketplace API, FB Marketplace scraper, Marketplace price tracker or deal finder.

Changelog

What changed in the Facebook Marketplace Scraper

  • 2026-11-16 · New: Notifications can also go to WhatsApp (WhatsApp Cloud API of your Meta business account), to up to 5 numbers and with your approved message template so they arrive at any time; wrong notification settings now stop the run at its start, before anything is read.
  • 2026-11-16 · Fixed: A URL, code or search the website rejected or did not answer is reported as not read (try again later), never as not found or as a page that does not exist.
  • 2026-11-15 · New: Send error reports in the Privacy section: turn it off and the actor sends nothing to its developer when a run fails.
  • 2026-11-15 · Fixed: Discord and Slack webhooks are accepted in every form you can copy them in, including Discord beta clients and links in angle brackets; a channel link is refused with advice where to copy the webhook.

Support

Missing a field or a filter?

We read every message and usually answer the same day. Small changes to an actor are free; a custom scraper gets a fixed quote.