Facebook Marketplace Scraper

Thirdwatch portfolio: 5K users across 88 public Actors, 2M+ records delivered, and >99% run success. Explore all Thirdwatch Actors.

Scrape Facebook Marketplace listings by keyword, location, category, search URL, or item URL. Get one clean dataset row per listing with prices, descriptions, photos, coordinates, condition, delivery options, timestamps, and structured vehicle data.

This Actor reads the public Facebook Marketplace Relay data directly over HTTP. It does not launch a browser, require a Facebook login, or charge for empty diagnostic rows. That makes scheduled price tracking and new-listing monitoring fast and economical. Full item-page enrichment is optional, so high-frequency search monitors do not pay the much higher network cost of downloading every detail page.

What you can do

• Monitor newly listed Marketplace items in a city
• Track second-hand prices and local inventory
• Find cars by make, model, price, condition, and radius
• Collect full item descriptions and image galleries
• Build local resale, market-research, and lead-generation datasets
• Feed listing data into Google Sheets, webhooks, Zapier, Make, or your API

Why use this Facebook Marketplace scraper?

• Public HTTP extraction: no browser startup, Facebook credentials, or user cookies
• One row per listing: easy to export and process; no nested result batches
• Real pagination: uses the query ID and cursor supplied dynamically by Facebook
• Rich detail enrichment: descriptions, all photos, GPS, attributes, and vehicle specs
• Monitoring mode: return only listing IDs not seen in earlier runs
• Fair billing: a result event is charged only when a unique listing is returned
• Low price: from $0.70 to $1.20 per 1,000 listings, depending on your Apify tier

Quick start

Search for listings in New York:

{
  "queries": ["used sofa", "standing desk"],
  "location": "nyc",
  "maxResultsPerQuery": 50,
  "includeDetails": false
}

Find newly listed cars within a price range:

{
  "queries": ["Toyota Camry"],
  "location": "losangeles",
  "minPrice": 5000,
  "maxPrice": 18000,
  "radiusKm": 50,
  "sortBy": "creation_time_descend",
  "daysSinceListed": "7",
  "includeDetails": true
}

Scrape a saved search, category, or individual item directly:

{
  "startUrls": [
    {"url": "https://www.facebook.com/marketplace/nyc/vehicles"},
    {"url": "https://www.facebook.com/marketplace/item/123456789012345/"}
  ],
  "maxResultsPerQuery": 100
}

Input options

Field	Description	Default
queries	Marketplace keywords to search	used sofa
location	Marketplace URL location slug such as nyc, london, or sydney	nyc
searchUrls	Existing Marketplace search or category URLs	—
startUrls	Direct item, search, or category URLs	—
maxResultsPerQuery	Maximum unique results per query or URL, up to 1,000	50
includeDetails	Enrich descriptions, photos, coordinates, attributes, and vehicles	false
minPrice / maxPrice	Price filters	—
radiusKm	Search radius from 1 to 500 km	65
sortBy	Relevance, newest, price ascending, or price descending	relevance
itemCondition	Any, new, like new, good, or fair	any
daysSinceListed	Any time, 1 day, 7 days, or 30 days	any
deliveryMethod	All, local pickup, or shipping	all
monitoringMode	Return only listing IDs not seen in previous runs	false
monitoringKey	Optional stable key that isolates one monitor's history	derived from searches

You may supply queries, URLs, or both. Filters entered separately apply to generated query URLs; filters already present in supplied URLs are preserved.

Up to 20 combined queries, searches, categories, and direct item URLs can be processed in one run. Larger workloads should be split across Tasks so failures and schedules remain isolated.

Output fields

Every dataset item represents one unique Marketplace listing.

Field	Meaning
id, item_url	Facebook listing ID and canonical Marketplace URL
title, description	Listing title and full public description
price, currency, formatted_price	Current numeric and display price
original_price, formatted_original_price	Previous price when Facebook exposes one
location, city, state	Public listing location
latitude, longitude	Public item coordinates when exposed
condition, attributes	Condition and other listing attributes
primary_image_url, photos, photo_count	Main image and full photo gallery
delivery_types	Pickup and shipping options
creation_time, created_at	Listing publication time, when Facebook exposes it
is_live, is_sold, is_pending	Listing status flags
vehicle	Make, model, trim, odometer, transmission, fuel, VIN, colors, title status, specifications, and features when disclosed
source_query, searched_location, search_url	Source and reproducibility metadata
scraped_at	UTC extraction timestamp

Example output:

{
  "id": "123456789012345",
  "item_url": "https://www.facebook.com/marketplace/item/123456789012345/",
  "title": "2019 Toyota Camry SE",
  "description": "Clean title, one owner...",
  "price": 15900,
  "currency": "USD",
  "location": "Los Angeles, California",
  "latitude": 34.0522,
  "longitude": -118.2437,
  "condition": "Used - Good",
  "photo_count": 12,
  "vehicle": {
    "make": "Toyota",
    "model": "Camry",
    "trim": "SE",
    "transmission": "Automatic"
  }
}

Monitoring new Facebook Marketplace listings

Enable monitoringMode and schedule the Actor. The Actor stores previously returned listing IDs in a persistent named key-value store, then emits only newly discovered listings. Its history key is derived from the searches and URLs, or you can set monitoringKey explicitly. Connect a webhook to receive alerts without maintaining your own deduplication database.

For isolated monitors, create a separate Apify Task per saved search so each Task keeps the intended input and schedule.

The monitor retains the most recent 100,000 listing IDs per monitoring key. Use separate keys for unrelated markets or long-running high-volume feeds.

Migrating from version 1

Version 2 returns one dataset row per listing. Version 1 returned one batch object containing a nested listings array plus diagnostic fields such as block_reason. Update integrations to iterate dataset rows directly. Failed or blocked requests now fail explicitly and do not create billable diagnostic rows.

Pricing

This Actor uses transparent pay-per-event pricing. You pay for unique listings actually written to the dataset:

• FREE: $1.20 per 1,000 listings
• BRONZE: $1.00 per 1,000 listings
• SILVER: $0.80 per 1,000 listings
• GOLD: $0.70 per 1,000 listings

When includeDetails succeeds, the additional enrichment price is $2.70 / $2.50 / $2.30 / $2.20 per 1,000 enriched listings from FREE through GOLD. Search-only monitoring remains at the base listing price. There is no start fee, failed enrichments are not charged, and failed or empty searches do not produce billable diagnostic records.

Public-data limitations

Facebook changes its public Marketplace interface without notice. Some regions, listings, or fields may require a logged-in Facebook session and therefore cannot be returned by an anonymous public-data Actor. Seller identity is commonly withheld from anonymous visitors; this Actor returns seller: null rather than claiming unavailable private data. VIN and some vehicle fields appear only when the seller discloses them.

The Actor accesses public pages only. Use the data in accordance with applicable laws and Facebook's terms, and avoid collecting personal data without a lawful purpose.

Support

If a public Marketplace URL stops returning data, open an issue with the Actor run ID, location slug, and a redacted example URL. Do not include Facebook credentials or private account cookies.