Facebook Marketplace Scraper ⚡

Collect Facebook Marketplace listings by keyword and location with clean, structured JSON output. Built as an Apify Actor with robust retries, batching, and configurable inputs for reliable and scalable runs.

---

Why use this Facebook Marketplace Scraper? 🚀

• Targeted search: Query by keyword with precise latitude/longitude.
• Actionable results: Normalized fields (price, location, delivery types, etc.).
• Production-ready: Retries, key rotation, batched dataset writes.

Target keyword: Facebook Marketplace Scraper

Related keywords: Facebook Marketplace data, Marketplace listings, Marketplace scraper, Facebook listings search, local classifieds scraper, e-commerce scraping, second-hand items data.

---

Table of Contents 📚

• Features
• How it works
• Input configuration
• Example input
• Example output
• Best practices
• FAQ
• Changelog

---

Features ✨

Capability	What you get
Keyword + Geo search	Query Marketplace with query, lat, lng
Filters	Optional radius_km, min_price, max_price, condition
Normalized output	Clean fields for price, location, title, delivery types
Scalable	Retries, keys, batched dataset writes

---

How it works 🧠

• Sends a search request using your inputs, retries on transient errors, rotates keys when needed, and writes results to the default Apify dataset in batches.
• Responses are normalized to a consistent JSON schema for analytics and pipelines.

---

Input configuration ⚙️

Keys defined in input_schema.json:

• query (string, required) — Keyword to search (e.g. car, iPhone 14).
• lat (number, required) — Latitude for the location (e.g. 40.7128).
• lng (number, required) — Longitude for the location (e.g. -74.006).
• radius_km (number, optional) — Search radius in kilometers.
• min_price (number, optional) — Minimum price filter.
• max_price (number, optional) — Maximum price filter.
• condition (string, optional) — Item condition filter. One of: used_like_new, used_good, used_fair, new.

---

Example input 📥

{
  "query": "car",
  "lat": 40.7128,
  "lng": -74.006,
  "radius_km": 20,
  "min_price": 1000,
  "max_price": 10000,
  "condition": "used_good"
}

---

Example output 📤

Dataset items (normalized in main.js):

{
  "source": "facebook_marketplace",
  "listing_id": "771476635286470",
  "category_id": "807311116002614",
  "title": "1984 Lincoln Town Car",
  "price_amount": 6600,
  "price_formatted": "$6,600",
  "strikethrough_amount": 15000,
  "image_url": "https://...jpg",
  "location_city": "Staten Island",
  "location_state": "NY",
  "city_display_name": "New York, New York",
  "is_live": true,
  "is_pending": false,
  "is_sold": false,
  "delivery_types": ["IN_PERSON"],
  "query": "car",
  "lat": 40.7128,
  "lng": -74.006,
  "fetched_at": "2025-01-01T12:34:56.000Z",
  "raw": { "...": "original item payload" }
}

A final summary item is also written:

{
  "success": true,
  "total_pushed": 42,
  "query": "car",
  "lat": 40.7128,
  "lng": -74.006,
  "fetched_at": "2025-01-01T12:34:56.000Z"
}

---

Best practices 🧩

• Validate inputs: Keep query specific and ensure lat/lng match the target area.
• Start small: Test with a low limit first to validate output structure.
• Respect rate limits: Keep parallelism reasonable and rely on built-in retries.

---

FAQ ❓

• Is login required?
  No. This scraper targets public listing data.

• Where do results go?
  The default Apify dataset for the run.

• How to get Facebook Marketplace?
  On the Facebook app, tap the menu (☰) and choose Marketplace. On desktop, open facebook.com and click Marketplace from the left sidebar. If you don't see it, Marketplace may not be available in your region or for your account type.

• How does Facebook Marketplace work?
  Individuals list items with photos, price, title, and location. Buyers search by keyword and location, filter by price and distance, then message the seller to arrange pickup or shipping. Listings can be marked as available, pending, or sold.

• What does OBO mean on Facebook Marketplace?
  OBO stands for “Or Best Offer.” It signals the seller is open to negotiating the listed price.

• Can you use Facebook Marketplace without a Facebook account?
  Generally, you need a Facebook account to fully browse listings and contact sellers. Some content may be visible publicly, but messaging and complete access typically require being logged in.

---

Changelog 📦

• 1.0.0 — Initial Facebook Marketplace search Actor with input schema, batching, retries, and normalized output.

---