Facebook Marketplace Scraper

Facebook Marketplace Scraper

The Facebook Marketplace Scraper is an Apify actor for Facebook Marketplace data extraction that collects search results and (optionally) visits item pages to pull richer details at scale. This Facebook Marketplace scraper tool solves the manual overhead of combing through listings by automating Facebook Marketplace web scraping across bulk search URLs, with stable residential proxies and built-in retries. It’s ideal for marketers, developers, data analysts, and researchers who want to scrape Facebook Marketplace listings for product research, price tracking, and data pipelines — and to export results to CSV/JSON for downstream use, fast.

What data / output can you get?

Each listing is saved as one row in the default Apify dataset. In search mode, rows include the structured fields below. In deep mode, rows come from product-detail page (PDP) data and always include id and listing_price (with either location or location_text), plus the standard helper fields (query, priceFormatted, listingUrl).

• Export to JSON or CSV from the dataset UI or API.

Data type	Description	Example value
query	Search query that produced the listing (or “deep_scraped” in deep mode)	"phone"
id	Listing ID	"123456789012345"
listingUrl	Direct item URL (auto-derived if missing)	"https://www.facebook.com/marketplace/item/123456789012345"
facebookUrl	Source search URL for the query	"https://www.facebook.com/marketplace//search/?query=phone"
marketplace_listing_title	Listing title	"iPhone 12 Pro 128GB"
priceFormatted	Price as a simplified string derived from listing_price	"199"
listing_price	Raw price object with formatted amount/currency fields	{"formatted_amount_zeros_stripped":"199","currency":"USD"}
primary_listing_photo	Primary photo metadata including image.uri and id	{"__typename":"ProductImage","image":{"uri":"https://...jpg%22%7D,%22id%22:%22987654321"}
location	Location object from the listing (structure varies)	{...}
is_live	Whether the listing is live	true
is_pending	Whether the listing is pending	false
is_sold	Whether the item is sold	false
marketplace_listing_seller	Seller object from the listing (if available)	{...}
delivery_types	Available delivery types	["LOCAL_PICKUP","SHIPPING"]
strikethrough_price	Former price (if provided)	null
comparable_price	Comparable price data (if provided)	null
comparable_price_type	Type of comparable price (if provided)	null
custom_title	Custom title (if present)	null
custom_sub_titles_with_rendering_flags	Additional subtitles and flags	[]
origin_group	Origin group (if present)	null
listing_video	Video metadata (if present)	null
parent_listing	Parent listing reference (if present)	null
marketplace_listing_category_id	Category ID	"1234"

Note: In deep mode, items are extracted from PDP responses and can contain additional fields beyond the search snippet. All rows still include query, priceFormatted, and listingUrl (auto-filled from id when needed).

Key features

• ⚡ Always-on residential proxies with stable session
  Enforces Apify RESIDENTIAL proxy for the entire run with a single session ID (same IP) and up to 3 retries for resilience against blocks.

• 📦 Bulk URL support
  Paste multiple Facebook Marketplace search URLs and the Facebook Marketplace crawler will paginate and collect results per URL.

• 🔍 Deep Scrape (PDP) mode
  Optionally fetch listing details by visiting item pages. The actor deduplicates listing IDs collected across URLs before issuing parallel PDP requests for efficiency.

• 🔁 Pagination with max-per-URL control
  Set Max listings per URL via the count parameter (0 = unlimited). The scraper stops at exactly your limit where possible.

• 📊 Structured dataset output
  One row per listing with query, id, listingUrl, marketplace_listing_title, priceFormatted, and the raw listing fields — ready to Export Facebook Marketplace listings to CSV or JSON.

• 🧰 Developer-friendly & automation-ready
  Integrate via the Apify API or run as a Python Facebook Marketplace scraper workflow using Apify’s Python/JS SDKs. Connect to Make, n8n, or webhooks to power pipelines.

• 🧠 Smart block detection & retries
  Detects common block statuses and short-content responses, then retries with stable residential connectivity for reliability at scale.

How to use Facebook Marketplace Scraper - step by step

1. Create or sign in to your Apify account.
2. Open the “facebook-marketplace-scraper” actor in the Apify Console.
3. Add input data:
   • Paste one or more Marketplace search URLs into urls (accepts string list or objects with a url field).
   • Example: https://www.facebook.com/marketplace/108479165840750/search/?query=phone&exact=false
4. Configure settings:
   • deepScrape: true to visit item pages for richer details, false for search-only results.
   • count: limit listings per URL (0 = unlimited).
   • proxyConfiguration: optional Apify Proxy preferences (e.g., country). The actor will force RESIDENTIAL proxy with a stable session.
5. Start the run and monitor logs for progress, pagination, and retries.
6. View results in the Dataset tab. Each listing is pushed in real time as a separate row.
7. Export data to JSON or CSV for analysis, reporting, or ingestion into your systems.

Pro Tip: Schedule the actor or trigger it via the Apify API to build a fully automated Facebook Marketplace scraping software pipeline that feeds your BI tools or price monitoring dashboards.

Use cases

Use case name	Description
Market research & product research	Aggregate titles, prices, and locations to analyze supply, pricing, and trends by query or geo for Facebook Marketplace listing scraper workflows.
Facebook Marketplace price monitoring	Track priceFormatted and listing_price fields over time for categories or saved searches to power alerts and dashboards.
Lead generation & seller outreach	Collect marketplace_listing_seller and listing links for outreach lists and enrichment (public data only).
E‑commerce sourcing & arbitrage	Identify profitable items by scraping Facebook Marketplace listings across multiple search URLs and exporting to CSV.
Competitive tracking	Monitor availability, is_sold, and is_pending signals across comparable listings to infer demand dynamics.
Analytics & ETL pipelines	Use the Apify API to pipe JSON results into warehouses and data lakes as part of a Facebook Marketplace data scraper pipeline.
Academic & regional studies	Study location distributions and listing behavior by area for economic or social research using Facebook Marketplace web scraping.

Why choose Facebook Marketplace Scraper?

This tool is built for precision, automation, and reliability — a production-ready Facebook Marketplace scraping service that scales.

• ✅ Accurate, structured output with one row per listing (query, priceFormatted, listingUrl, and raw fields)
• 🌐 Stable residential proxies with a single session per run and up to 3 retries
• 📦 Batch scraping across many search URLs with optional deep-scrape details
• 🧪 Developer access via Apify API and SDKs; easy to embed in Python/data workflows
• 🔒 Public data focus and ethical usage; no login or private data access
• 💸 Export-ready results (JSON/CSV) to streamline downstream analysis and enrichment
• 🧰 More robust than browser extensions or ad-hoc tools — designed for consistent uptime and scale

Bottom line: a focused FB Marketplace scraper that outperforms unstable alternatives with production-grade infrastructure.

Is it legal / ethical to use Facebook Marketplace Scraper?

Yes — when done responsibly. This actor collects publicly available Marketplace data and does not access private or password-protected content.

Guidelines for compliant use:

• Only scrape public data and respect the platform’s terms of service.
• Ensure your use complies with applicable laws and regulations (e.g., GDPR, CCPA).
• Avoid using scraped data for spam or abusive activities.
• Do not attempt to access private profiles or gated resources.
• Consult your legal team for edge cases or regulated workflows.

Input parameters & output format

Example JSON input

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

Input fields

• urls (array, required): Paste one or more Facebook Marketplace search URLs. Example: https://www.facebook.com/marketplace/108479165840750/search/?query=phone — Add as many as you need!
  • Default: none (required)
• count (integer, optional): Limit how many listings to scrape per URL. Set to 0 for unlimited.
  • Default: 20 (minimum: 0)
• deepScrape (boolean, optional): Turn ON to visit each listing's detail page and get full data (description, attributes, etc.). Turn OFF for search results only.
  • Default: true
• proxyConfiguration (object, optional): This actor always uses residential proxy regardless of your choice. Same IP for the whole run; up to 3 retries on failure. You can still set Apify Proxy options (e.g., country) — RESIDENTIAL group is enforced.
  • Default prefill: {"useApifyProxy": false}

Output format

• The actor pushes one dataset item per listing in real time.
• In search mode, each item includes query (search term) and priceFormatted in addition to the raw listing fields.
• In deep mode, each item includes query set to "deep_scraped" and fields extracted from the PDP response (at minimum id and listing_price with location or location_text), plus priceFormatted and listingUrl auto-filled from id when needed.

Example dataset item (search results mode)

{
  "facebookUrl": "https://www.facebook.com/marketplace//search/?query=phone",
  "listingUrl": "https://www.facebook.com/marketplace/item/123456789012345",
  "id": "123456789012345",
  "primary_listing_photo": {
    "__typename": "ProductImage",
    "image": { "uri": "https://example-cdn.com/photo.jpg" },
    "id": "987654321"
  },
  "listing_price": {
    "formatted_amount_zeros_stripped": "199",
    "currency": "USD"
  },
  "strikethrough_price": null,
  "comparable_price": null,
  "comparable_price_type": null,
  "location": { },
  "is_hidden": false,
  "is_live": true,
  "is_pending": false,
  "is_sold": false,
  "is_viewer_seller": false,
  "min_listing_price": null,
  "max_listing_price": null,
  "marketplace_listing_category_id": "1234",
  "marketplace_listing_title": "iPhone 12 Pro 128GB",
  "custom_title": null,
  "custom_sub_titles_with_rendering_flags": [],
  "origin_group": null,
  "listing_video": null,
  "parent_listing": null,
  "marketplace_listing_seller": { },
  "delivery_types": ["LOCAL_PICKUP"],
  "query": "phone",
  "priceFormatted": "199"
}

Example dataset item (deep-scrape PDP mode)

{
  "id": "1976698959927469",
  "listing_price": {
    "formatted_amount_zeros_stripped": "349",
    "currency": "USD"
  },
  "location_text": { "text": "Austin, TX" },
  "marketplace_listing_title": "Gaming PC - RTX 3060",
  "query": "deep_scraped",
  "priceFormatted": "349",
  "listingUrl": "https://www.facebook.com/marketplace/item/1976698959927469"
}

Notes:

• listingUrl is auto-generated from id if missing.
• priceFormatted is derived from listing_price.formatted_amount_zeros_stripped or amount when present; it can be empty if the source price object lacks those fields.
• Deep mode fields vary by the PDP response; by design, each extracted node includes id and listing_price and either location or location_text.

FAQ

Is there a free trial?

Yes. This actor’s listing provides 120 trial minutes so you can evaluate Facebook Marketplace web scraping on your dataset before subscribing.

Do I need to log in to scrape Facebook Marketplace?

No. The actor targets publicly available Marketplace pages and does not use authentication. It operates without cookies or login to collect public data only.

How do proxies work in this scraper?

The actor always uses Apify Residential proxy with a stable session (same IP for the whole run) and retries up to 3 times on failure. You can still set Apify Proxy preferences (e.g., country); the RESIDENTIAL group is enforced.

Can I scrape multiple search URLs in one run?

Yes. Add as many Marketplace search URLs as you need to the urls array. The Facebook Marketplace listing scraper paginates each URL and streams results into the dataset.

How many listings can I collect per URL?

Use the count parameter to control limits. Set count to 0 for unlimited results. Internally, the actor paginates in batches and respects your cap precisely when possible.

What data points are included?

Search-mode rows include id, listingUrl, marketplace_listing_title, listing_price, priceFormatted, primary_listing_photo, location, and more (e.g., is_sold, is_pending, marketplace_listing_seller, delivery_types). Deep mode rows come from PDP responses and at minimum include id and listing_price plus location or location_text.

Can I use this with Python or an API?

Yes. You can orchestrate runs and retrieve datasets using the Apify API or SDKs. Many teams use this as a Python Facebook Marketplace scraper building block in ETL pipelines.

Is this a Chrome extension?

No. This is an Apify actor (server-side Facebook Marketplace scraping software), not a Facebook Marketplace scraper Chrome extension. It’s more stable and scalable for production use.

How do I export results?

Open the Dataset tab after your run and export to JSON or CSV. You can also access the dataset programmatically via the Apify API for automation.

Does it deduplicate items?

In deep-scrape mode, the actor deduplicates listing IDs across all provided URLs before fetching PDP details to avoid redundant requests. Search-mode results stream as they are collected.

Closing thoughts

The Facebook Marketplace Scraper is built to scrape Facebook Marketplace listings reliably and at scale. With stable residential proxies, bulk URL support, optional deep-scrape details, and structured dataset output, it helps marketers, developers, data analysts, and researchers move from manual browsing to automated Facebook Marketplace data extraction. Use the Apify API or SDKs to integrate this FB Marketplace scraper into your pipelines, export results to CSV/JSON, and automate your product research and price monitoring workflows. Start extracting smarter, structured insights from Facebook Marketplace today.