Skip to content
Leboncoin

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.0

When 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.

1Request
The listing's id, or its URL as it appears in the browser.
1 credit a call
Code, from the fields above
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"
    }
  }'
2Response

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

listingstringrequired
The listing's id, or its URL as it appears in the browser.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
listing_idstring
Leboncoin's listing id.
urlstring
The listing's address. Null for a listing gone that was given by its id alone: the id does not say its category, and Leboncoin no longer does.
statusstring
active: online, shown in searches. paused: its seller paused it; its page still shows it, searches no longer do. gone: no longer online, whether it expired, was deleted by its seller or by Leboncoin, was sold, or never existed: Leboncoin answers all of these the same way, so no one can tell them apart. Another word is Leboncoin's own for a state it adds, given as it is.
status_codeinteger
Leboncoin's HTTP status for the listing, 200 when it is online, 410 when it is gone.
published_atdate
When the listing was first published, UTC. Null when it is gone.
republished_atdate
When it last went back to the top of the searches (a renewal, an edit, a paid option), UTC.
expires_atdate
When Leboncoin will take it offline unless renewed, UTC, when Leboncoin says so (some listings only).
source_urlstring
The page or address these values were read from.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_listing422The value is neither a leboncoin.fr listing id nor a listing URL.
site_challenge503Leboncoin asked to prove a person is there; retry in a minute (not charged). Retryable.
site_unavailable503Leboncoin did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424Leboncoin 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
First version on the API v2, in place of the v1 Leboncoin Listing Status Checker: one listing a call, no account, its state (active, paused, gone) with Leboncoin's status code and the listing's dates.