Facebook Marketplace Scraper

Scrape Facebook Marketplace search results and optional listing details (PDP) at scale. Supports bulk URLs, configurable proxy, and automatic proxy fallback when the platform blocks requests.

Why Choose Us?

• Bulk URLs – Process many search URLs in one run.
• Deep scrape – Optionally fetch full listing details from each item page.
• Proxy fallback – Starts with no proxy; if blocked, falls back to datacenter then residential (with clear logs).
• Structured output – Same shape as the reference output: results grouped by search query or deep_scraped.

Key Features

• No proxy by default; optional Apify Proxy with automatic fallback (datacenter → residential, 3 retries, then stick to residential).
• Regular mode: search-only listings (title, price, location, photo, etc.).
• Deep mode: full PDP data (description, attributes, taxonomy, etc.).
• Pagination over search results and concurrent PDP requests in deep mode.
• Detailed Apify logs for progress and proxy events.

Input

Field	Type	Required	Description
urls	array	Yes	Marketplace search URLs (bulk). Example: https://www.facebook.com/marketplace/108479165840750/search/?query=phone
proxyConfiguration	object	Yes	Proxy settings. Default: no proxy. Editor: proxy.
deepScrape	boolean	No	If true, fetch full listing details per item (default: true).
count	integer	No	Max listings per URL; 0 = unlimited (default: 50).

Example input

{
  "urls": [
    { "url": "https://www.facebook.com/marketplace/108479165840750/search/?query=phone&exact=false" }
  ],
  "proxyConfiguration": { "useApifyProxy": false },
  "deepScrape": true,
  "count": 50
}

Output

One object pushed to the default dataset. Keys are search query strings (or "deep_scraped" in deep mode); values are arrays of listing objects.

Example output (regular mode)

{
  "phone": [
    {
      "facebookUrl": "https://www.facebook.com/marketplace//search/?query=phone",
      "listingUrl": "https://www.facebook.com/marketplace/item/123",
      "id": "123",
      "primary_listing_photo": { ... },
      "listing_price": { "formatted_amount_zeros_stripped": "...", "currency": "..." },
      "location": { ... },
      "marketplace_listing_title": "...",
      ...
    }
  ]
}

Example output (deep mode)

{
  "deep_scraped": [
    {
      "id": "1976698959927469",
      "listing_price": { ... },
      "location_text": { "text": "..." },
      "marketplace_listing_title": "...",
      "redacted_description": { "text": "..." },
      "attribute_data": [ ... ],
      ...
    }
  ]
}

How to Use the Actor (via Apify Console)

1. Log in at console.apify.com and open Actors.
2. Find facebook-marketplace-scraper and open it.
3. Set Input: add marketplace URLs (bulk), set proxy (default: no proxy), and optionally Deep scrape and Max listings per URL.
4. Click Start.
5. Watch Log for progress and proxy messages.
6. Open the Output tab to view or export the dataset (JSON/CSV).

Best Use Cases

• Price and listing research for specific queries and locations.
• Collecting public listing data for analysis or feeds.
• Monitoring categories or search terms over time.

Frequently Asked Questions

• Why no proxy by default? To avoid proxy cost when the platform allows direct access. Proxy is used only when needed (block/rejection).
• What if I get blocked? The actor will log and switch to datacenter proxy, then residential (up to 3 retries), then use residential for the rest of the run.
• What is “deep scrape”? It visits each listing’s detail page and returns full PDP data (description, condition, category path, etc.) instead of only search-snippet fields.

Support and Feedback

Use the Apify platform support or the actor’s repository for issues and feature requests.

Cautions

• Data is collected only from publicly available marketplace pages.
• No access to private or password-protected content.
• You are responsible for compliance with applicable laws (privacy, data protection, terms of use).