Facebook Marketplace Listings Scraper

---

📋 Overview

Facebook Marketplace Listings Scraper is an Apify Actor that extracts product listings from Facebook Marketplace search pages. Simply provide one or more Marketplace search URLs, and the Actor will automatically scrape all listing cards with titles, prices, locations, seller information, and optionally visit each listing's detail page to extract extended information like full descriptions, all photos, attributes, and seller details.

🎯 Use Cases Price monitoring & tracking Market research & analysis Competitor intelligence Inventory tracking Data aggregation platforms Lead generation Trend analysis

⚡ Key Features Automatic pagination Fast & deep scrape modes Anti-blocking measures Proxy rotation support Structured data export API integration ready Scheduled monitoring

This Actor serves as a Facebook Marketplace API alternative for businesses, researchers, and developers who need to collect listing data at scale. Whether you're conducting market research, price monitoring, competitor analysis, or building a marketplace aggregation platform, this tool makes it easy to extract structured listing data from Facebook Marketplace.

---

🚀 Quick Start

---

✨ Features

🚀 Platform Advantages

When you use Facebook Marketplace Listings Scraper on the Apify platform, you get more than just a scraper

� Automation & Monitoring Scheduled runs for tracking over time Webhook notifications Automatic retries & error handling 🔌 Integration Ready REST API access Zapier & Make connectors Python/JavaScript SDKs

🛡️ Reliability & Scale Built-in proxy rotation Session management Scalable infrastructure Graceful degradation 💾 Data Export JSON, CSV, Excel, HTML formats Structured & clean data Pay-per-event pricing

---

📊 Data Extraction

📦 Core Fields (Always Present)

Field	Description	Example
id	Unique listing identifier	"123456789"
url	Canonical listing URL	"https://www.facebook.com/..."
title	Listing title	"Vintage Leather Jacket"
priceFormatted	Formatted price string	"$150"
priceNumeric	Numeric price value	150
currency	Currency code	"USD"
locationText	Location text	"New York, NY"
thumbnailUrl	Main image thumbnail	"https://..."
sellerName	Seller's display name	"John Smith"
sellerProfileUrl	Link to seller profile	"https://www.facebook.com/..."
isSold	Whether listing is sold	true/false
isPending	Whether listing is pending	true/false
isLive	Whether listing is active	true/false
scrapedAt	ISO timestamp	"2024-12-31T12:00:00Z"

🔍 Extended Fields (Deep Scrape Only)

Note: Available when deepScrape=true

Field	Description
description	Full listing description with complete text
allPhotoUrls	Array of all photo URLs from the listing
attributes	Object with listing attributes/features (condition, brand, size, etc.)
latitude/longitude	Geographic coordinates (if available)
deliveryTypes	Available delivery options (pickup, delivery, shipping, etc.)
seller	Extended seller information (join date, profile picture, etc.)

---

💰 Pricing

💵 Cost Estimates Mode Cost per Listing Fast Mode ~$0.001-0.01 Deep Scrape ~$0.01-0.05

📈 Example Scenarios Listings Fast Mode Deep Scrape 100 $0.10-1 $1-5 1,000 $1-10 $10-50 10,000 $10-100 $100-500

---

⚙️ Input Configuration

📋 Input Example

{
  "urls": [
    "https://www.facebook.com/marketplace/nyc/cars/",
    "https://www.facebook.com/marketplace/search/?query=vintage+furniture"
  ],
  "deepScrape": false,
  "count": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "countryCode": "US"
  },
  "maxConcurrency": 10,
  "maxRequestRetries": 3,
  "debugLog": false
}

---

📤 Output Data

📄 Fast Mode Output Example

🔍 Deep Scrape Output Example

💡 Note: The dataset is structured as a flat JSON array, making it easy to import into databases, spreadsheets, or data analysis tools.

---

💡 Best Practices & Tips

🎯 Performance Optimization

🔧 Advanced Usage

---

🔧 Troubleshooting

🐛 Debug Mode

Enable debugLog=true for verbose logging:

• 📝 Detailed extraction attempts
• 🎯 Selector matching information
• ❌ Error details for failed extractions
• 🚫 Blocking detection details

Enable includeRaw=true to include raw HTML snippets in output (for debugging page structure)

---

⚖️ Legal & Ethics

📜 Data Privacy

Our scrapers are ethical and do not extract any private user data, such as email addresses, phone numbers, or personal contact information beyond what users have chosen to share publicly on Facebook Marketplace. They only extract what is publicly visible on Marketplace listing pages.

⚠️ GDPR Compliance: Your results may contain personal data (seller names, profile links). Personal data is protected by GDPR in the EU and other regulations worldwide. Ensure you have a legitimate reason for scraping personal data. Consult your lawyers if unsure.

Learn more: Is Web Scraping Legal?

✅ Best Practices

Do's ✅ Respect Facebook's Terms of Service Use reasonable request rates Respect robots.txt Use for ethical purposes only Monitor for page structure changes

Don'ts ❌ Overload Facebook's servers Use data for spam/harassment Scrape private information Ignore rate limiting Violate data protection laws

💡 Built-in Protections: The Actor includes delays, proxy rotation, and rate limiting to be respectful of Facebook's infrastructure.

---

❓ FAQ

---

📞 Support & Resources

📚 Documentation & Learning 📖 Apify Documentation 📝 Web Scraping Blog 🎓 Apify Academy 🔧 API Reference

💬 Community & Help 🐛 Issues - Report bugs or request features 💭 Community - Join discussions on Discord 📧 Support - Contact Apify support team ⭐ Feedback - Share your experience

---