Classified Listings
Pricing
from $8.00 / 1,000 results
Search and track listings across Facebook Marketplace, OLX, Wallapop, Leboncoin and Custojusto through one unified API — one request shape, five sources, normalized results, plus price alerts that notify you when something new matches.
What this run should do. "search" runs a keyword search across one or more sources (the main use case). "listingDetail" fetches one listing's full detail. "sourceExtra" calls a source's own unique endpoint (categories, etc). "alertCheck" re-runs a saved search and reports only genuinely new listings since the last run with this same Alert State Key — intended to be triggered on a schedule.
Which classifieds sites to search. Used by "search" and "alertCheck". Leave empty to search all 5.
[]Keyword search text. Used by "search" and "alertCheck".
Source-specific category id/slug (use the "sourceExtra" operation with extraName="categories" to list them for Leboncoin/Custojusto). Optional.
Source-specific location filter: a city name for OLX/Custojusto, a zip/city for Leboncoin, "lat,lon" for Wallapop/Facebook (e.g. "40.4168,-3.7038"), or a raw Facebook location id for Facebook. Optional.
Minimum price filter, in the source's own currency. Optional.
Maximum price filter, in the source's own currency. Optional.
Result ordering. Used by "search" and "alertCheck".
Page number, starting at 1. Has no effect on Facebook (first page only). On Wallapop, prefer "cursor" below once you have one — it's far more efficient than paging forward.
Max listings to return per source, 1-100.
An opaque "nextCursor" value from a previous Wallapop search result — pass it back here to fetch the next page in one request instead of using "page".
When true, a "search" run also includes min/max/avg price stats grouped by source in the output.
A single source. Used by "listingDetail" and "sourceExtra".
Used by "listingDetail". For Wallapop/Facebook, the plain listing id (a search result's "sourceId"). For OLX/Custojusto/Leboncoin, the listing's full "url" field from a search result instead — these sites need the slug, not just the numeric id.
Used by "sourceExtra". One of: Leboncoin → "categories"; Custojusto → "categories"; OLX → "rawState"; Wallapop → "cars".
Used by "sourceExtra". Parameters for the chosen extra, e.g. {"id": ""} for OLX's rawState, or {"query": "golf", "brand": "Renault"} for Wallapop's cars.
{}If set and the "alertCheck" operation finds new matches, they're POSTed here as { query, sources, matches }.
Key-value store key this run's "seen listing ids" are kept under, so a later run (e.g. a scheduled one) only reports genuinely new matches. Use a distinct key per saved search.
A generic HTTP(S) proxy URL (e.g. http://user:pass@host:port), tried before falling back to the impit service below. Optional but recommended — most sources need this to avoid being blocked.
A residential proxy that rotates IP per connection, used by the impit fallback for anti-bot-protected sources (Leboncoin especially). Optional.
A residential proxy pinned to Spain, used for Wallapop. Optional — falls back to the rotating/base proxy above if not set.
A residential proxy pinned to Portugal, used for OLX and Custojusto. Optional — falls back to the rotating/base proxy above if not set.
Base URL of a service that fetches a URL with a real browser TLS fingerprint (impit, Firefox impersonation) and returns { status_code, content, headers } — used as the last-resort fallback when a direct/proxied request is blocked. Required for Leboncoin/Wallapop to reliably work. Optional for OLX/Custojusto/Facebook.
Advanced: override the x-appversion header Wallapop requires. Leave blank to use the built-in default.
Advanced: override the x-deviceid header Wallapop requires. Leave blank to use the built-in default.
Advanced: override the x-deviceos header Wallapop requires. Leave blank to use the built-in default.
Advanced: override the default Facebook-internal location id used when "location" isn't a raw location id. Leave blank to default to the San Francisco Bay Area.