Check a listing is still online
Whether a leboncoin.fr listing is still online (active, paused by its seller, or gone), with its dates.
leboncoin/listings/check1 credit a callv1.0.0When to use it
You have Leboncoin listings (from leboncoin/listings/search, or their URLs) and need to know which are still online: before contacting a seller, to drop sold or expired listings from a list, or to follow a listing over time. One call checks one listing. For what the listing says (its price, its description), use leboncoin/listings/get.
Try it
The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.
curl https://api.lobstr.io/v2/run \ -H "Authorization: Bearer $LOBSTR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "source": "leboncoin", "operation": "listings/check", "options": { "listing": "https://www.leboncoin.fr/ad/voitures/3000000001" } }'
An example answer, from the contract. Run it on your own input with your API key.
{ "object": "run", "id": "run_4kq734azxjpjgrn3fsba4ev2pe", "livemode": true, "source": "leboncoin", "operation": "listings/check", "version": "1.0.0", "schema_url": "https://api.lobstr.io/v2/catalog/leboncoin/listings/check", "options": { "listing": "https://www.leboncoin.fr/ad/voitures/3000000001" }, "fields": null, "status": "succeeded", "count": 1, "has_more": false, "next": null, "cost": { "credits": 1 }, "results": [ { "object": "listing_status", "listing_id": "3000000001", "url": "https://www.leboncoin.fr/ad/voitures/3000000001", "status": "active", "status_code": 200, "published_at": "2026-11-10T14:46:42Z", "republished_at": "2026-11-10T14:46:42Z", "expires_at": "2027-01-09T14:46:42Z", "source_url": "https://www.leboncoin.fr/ad/voitures/3000000001", "observed_at": "2026-11-10T17:02:11Z" } ] }
Options
listingstringrequiredRecord
Each record of results, in the envelope every call returns (Run an operation).
objectstringlisting_idstringurlstringstatusstringstatus_codeintegerpublished_atdaterepublished_atdateexpires_atdatesource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_listing | 422 | The value is neither a leboncoin.fr listing id nor a listing URL. |
site_challenge | 503 | Leboncoin asked to prove a person is there; retry in a minute (not charged). Retryable. |
site_unavailable | 503 | Leboncoin did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | Leboncoin answered in a shape we do not read yet; we are told and fix it, and it is not charged. |
Price
1 credit a call. A failed call is free. What a credit costs on each plan: Credits and pricing.
Changelog
1.0.02026-11-10