# Leboncoin: Check a listing is still online

`leboncoin/listings/check` · version 1.0.0 · pilot · 1 credits a call

Whether a leboncoin.fr listing is still online (active, paused by its seller, or gone), with its dates.

Categories: Real estate, Cars, E-commerce

## When to use

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.

## Call

```bash
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": "3000000001"}}'
```

The answer's `next` is the whole call for the following page: send it as it is. `null` on the last page.

Beside `options`, the call takes:

| Parameter | Type | Description |
|---|---|---|
| `fields` | array of string | The record fields to keep, by path (`title`, `address.city`); `object`, `id` and `position` always come. Left out: every field. |

## Options

| Option | Type | Required | Default | Description |
|---|---|---|---|---|
| `listing` | string | yes |  | The listing's id, or its URL as it appears in the browser. |

## Record

Each item of `results`. Every field is always present, `null` when the site gives nothing.

| Field | Type | Description |
|---|---|---|
| `object` | `"listing_status"` |  |
| `listing_id` | string | Leboncoin's listing id. |
| `url` | string | null (uri) | 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. |
| `status` | string | 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_code` | integer | Leboncoin's HTTP status for the listing, 200 when it is online, 410 when it is gone. |
| `published_at` | string | null (date-time) | When the listing was first published, UTC. Null when it is gone. |
| `republished_at` | string | null (date-time) | When it last went back to the top of the searches (a renewal, an edit, a paid option), UTC. |
| `expires_at` | string | null (date-time) | When Leboncoin will take it offline unless renewed, UTC, when Leboncoin says so (some listings only). |
| `source_url` | string (uri) | The page or address these values were read from. |
| `observed_at` | string (date-time) | When they were read |

Example:

```json
{
  "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"
}
```

## Price



## Errors

| Code | Status | Retry | Message |
|---|---|---|---|
| `invalid_listing` | 422 | no | The value is neither a leboncoin.fr listing id nor a listing URL. |
| `site_challenge` | 503 | yes | Leboncoin asked to prove a person is there; retry in a minute (not charged). |
| `site_unavailable` | 503 | yes | Leboncoin did not answer in time or refused the call; retry later (not charged). |
| `unexpected_answer` | 424 | no | Leboncoin answered in a shape we do not read yet; we are told and fix it, and it is not charged. |
| `missing_api_key` | 401 | no | No API key: send it as `Authorization: Bearer <key>`. |
| `invalid_api_key` | 401 | no | The key is not valid, or not anymore. |
| `insufficient_credits` | 402 | no | The call costs more credits than are left. |
| `unknown_operation` | 404 | no | No such source and operation in the catalog. |
| `timeout` | 408 | yes | The call did not finish within its deadline (not charged). |
| `invalid_body` | 422 | no | The body is not a call: source, operation, options. |
| `invalid_options` | 422 | no | An option is missing or out of its contract; `param` names it. |
| `invalid_idempotency_key` | 400 | no | The Idempotency-Key header is not printable ASCII, or too long. |
| `concurrency_limit` | 429 | yes | The plan's calls at a time are all in progress (Free 1, Starter 2, Pro 10, Team 50); retry when one has finished (not charged, never queued). |
| `service_busy` | 503 | yes | Too many calls at once on the account; retry in a few seconds. |
| `balance_unavailable` | 503 | yes | The balance could not be read; retry in a few seconds. |

## Changelog

- **1.0.0** (2026-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.

Schema: https://api.lobstr.io/v2/catalog/leboncoin/listings/check · All operations: https://api.lobstr.io/v2/catalog.md
