Facebook Marketplace Scraper 🛍️ Listings & Prices — Only $3/1K 💰

Extract Facebook Marketplace listings with title, price, location, images — and optional full details (description, seller, condition, category). No API key needed.

⚠️ Honest login notice: Facebook Marketplace shows full search results only when logged in. Without a session, guest results are often zero or heavily limited. For reliable runs, paste cookies from a logged-in facebook.com session into the cookies input (JSON array) and use RESIDENTIAL proxy groups. The actor handles login walls gracefully: it returns a diagnostic item instead of failing silently (never charges for it).

---

Input

Field	Type	Default	Description
searchQueries	string[]	["iPhone"]	Required. Keywords to search. One search per keyword.
locations	string[]	[]	Optional cities/areas (e.g. "Sao Paulo, Brazil"). One search per query × location.
maxListings	int	10	Max listings per run (1–50). Free-tier non-owner runs are capped at 5.
fetchDetails	bool	false	Open each listing to extract description, seller, condition, category, posted date. Slower. Forced OFF on free-tier.
cookies	JSON array	[]	Session cookies from a logged-in facebook.com session. Recommended for full results.
proxyConfig	proxy editor	Apify proxy ON	Use RESIDENTIAL groups if datacenter IPs get blocked.

Example input

{
  "searchQueries": ["iPhone 13", "bicicleta aro 29"],
  "locations": ["Sao Paulo, Brazil"],
  "maxListings": 20,
  "fetchDetails": true,
  "cookies": [],
  "proxyConfig": { "useApifyProxy": true, "groups": ["RESIDENTIAL"] }
}

---

Output

Each dataset item:

Field	Type	Notes
url	string	Listing URL (/marketplace/item/{id}/). Contract-required.
title	string	Listing title. Contract-required.
price	number	Parsed numeric price (e.g. 1499.0). null when not visible.
formatted_price	string	Raw price text (e.g. "R$ 1.499").
currency	string	BRL / USD / ... inferred from the formatted price.
location	string	City/area.
image_urls	string[]	Image URLs.
listing_id	string	Marketplace listing ID.
category	string	Category (details mode).
posted_at	string	ISO date (API mode) or relative text (DOM mode).
seller_name	string	Seller name (details mode).
condition	string	New/Used/... (details mode).
description	string	Full description (details mode).
searchQuery / inputLocation	string	Which query/location produced the item.
scrapedAt	string	UTC ISO timestamp of collection.
_dataQuality	string	full (GraphQL), dom_only (DOM fallback), full_details (details enriched), diagnostic (guard item).

Invisible fields are null — the actor never fabricates data.

---

Pricing 💰

• Pay-per-event: event listing-scraped — $3 per 1,000 listings ($0.003 each).
• Charged only for valid items (contract: url + title present).
• Never charged for diagnostic/guard runs (login wall, blocked, region unsupported).
• Free tier: non-owner, non-paying runs are capped at 5 listings and fetchDetails is forced OFF.

---

Anti-bot & reliability

• Strategy cascade: GraphQL API interception (/api/graphql/, strips the for (;;); prefix) → embedded JSON → DOM fallback.
• Login wall / checkpoint / region block detection routes to a diagnostic item (setup_status: "DIAGNOSTIC_GUIDE") + SUCCEEDED, with actionable remediations.
• Residential proxy retry: if the first attempt yields zero items, the actor retries once with RESIDENTIAL.
• Debug artifacts (screenshot + HTML) are saved to the KV Store whenever a search returns zero items.
• Idempotent by design: re-running the same input produces the same items (no external state).

---

🇧🇷 Português

Coleta anúncios do Facebook Marketplace por palavra-chave (e opcionalmente por local). Campos: título, preço (número + texto formatado), moeda, localização, imagens, ID do anúncio, categoria, data de publicação e — com fetchDetails — descrição, vendedor, condição e categoria detalhada.

Aviso honesto: o Marketplace mostra resultados completos apenas logado. Para resultados confiáveis, cole cookies de uma sessão logada no campo cookies e use proxy RESIDENTIAL. Quando há bloqueio/muro de login, o actor devolve um item diagnóstico (nunca cobra por ele).

Preço: evento listing-scraped — US$ 3 por 1.000 anúncios (US$ 0,003 cada), cobrado só por itens válidos. Tier grátis (não-dono): máximo 5 anúncios por execução, fetchDetails forçado OFF.

---

Built for the ViralAnalyzer ecosystem · OWNER_USER_ID runs skip charges (test mode).