# Leboncoin: Get a listing

`leboncoin/listings/get` · version 1.0.0 · pilot · 3 credits a call

One leboncoin.fr listing, whole, by its id or URL, with a search's fields and how many people saved it.

Categories: Real estate, Cars, E-commerce

## When to use

You have a Leboncoin listing (its URL, or its id from a search) and need what it says: its title, description, price, photos, place, seller and every attribute (property, vehicle, job...), as it is now. A search gives the same fields for 35 listings a call; this reads one you already know, for example to follow its price. To know only whether it is still online, leboncoin/listings/check is cheaper; for the seller's number, leboncoin/phones/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/get", "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"` | The kind of record: a listing, whichever site it comes from. |
| `id` | string | Leboncoin's listing id; repeated in ids.listing_id. |
| `featured` | boolean | The listing has Leboncoin's "À la une" option (paid): searches show it with that badge, and at their top when sorted by date. |
| `url` | string (uri) | The listing on leboncoin.fr. |
| `title` | string |  |
| `description` | string | null | The seller's text, as written (line breaks kept). |
| `category` | object |  |
| `category.id` | string | Leboncoin's category id: 2 cars, 9 property sales, 10 rentals... |
| `category.name` | string | As Leboncoin names it |
| `ad_type` | `offer`, `demand` | An offer (selling, renting, hiring) or a demand (looking for). |
| `status` | string | Leboncoin's status of the listing: active on a search page. |
| `price` | object | null | The price the listing shows; null when it shows none (jobs, gifts). |
| `price.amount` | number |  |
| `price.currency` | `"EUR"` | ISO 4217. |
| `buyer_fee` | object | null | What Leboncoin adds for a buyer who pays on the site (its buyer protection); null when it does not apply. |
| `buyer_fee.amount` | number |  |
| `buyer_fee.currency` | `"EUR"` | ISO 4217. |
| `shipping` | array | The ways the seller ships, each with its price; empty when the listing is hand to hand only. |
| `shipping[].type` | string | null | Leboncoin's name of the carrier or service: mondial_relay, shop2shop, colissimo, custom_shipping... |
| `shipping[].price` | object | null | The price the listing shows; null when it shows none (jobs, gifts). |
| `shipping[].price.amount` | number |  |
| `shipping[].price.currency` | `"EUR"` | ISO 4217. |
| `shipping[].base_price` | object | null | The price before Leboncoin's discount, when it shows one. |
| `shipping[].base_price.amount` | number |  |
| `shipping[].base_price.currency` | `"EUR"` | ISO 4217. |
| `published_at` | string (date-time) | The first publication, UTC. |
| `republished_at` | string (date-time) | The date the listing shows and "Plus récentes" sorts by, UTC: its first publication, or the last time it was put back on top (an option, an edit). |
| `expires_at` | string | null (date-time) | When the listing goes offline unless renewed, UTC; null when Leboncoin does not say. |
| `has_phone` | boolean | The listing shows a "Voir le numéro" button: leboncoin/phones/get reads its number. |
| `is_boosted` | boolean | Leboncoin's own flag for a listing pushed by an option. |
| `paid_options` | object | The options the seller paid for, under Leboncoin's own names: urgent (the Urgent badge), photosup (more photos), booster and continuous_top_ads (put back on top), gallery, sub_toplist, highlight; has_option when any is on. |
| `paid_options.urgent` | boolean |  |
| `paid_options.gallery` | boolean |  |
| `paid_options.photosup` | boolean |  |
| `paid_options.sub_toplist` | boolean |  |
| `paid_options.continuous_top_ads` | boolean |  |
| `paid_options.highlight` | boolean |  |
| `paid_options.booster` | boolean |  |
| `paid_options.has_option` | boolean |  |
| `photos` | array | Every photo, in the listing's order, at the largest size Leboncoin serves. |
| `photos[].url` | string (uri) |  |
| `photos[].is_floor_plan` | boolean | Leboncoin's own reading of the photo as a floor plan (property listings). |
| `photo_count` | integer |  |
| `videos` | array |  |
| `videos[].url` | string (uri) |  |
| `videos[].provider` | string | null | youtube |
| `videos[].id` | string | null | The video's id at its provider. |
| `location` | object |  |
| `location.city` | string | null |  |
| `location.postal_code` | string | null |  |
| `location.district` | string | null | The part of the city, when the seller gave an address: Golfe Juan in Vallauris. |
| `location.department` | object | null |  |
| `location.department.id` | string | Leboncoin's id: the department's number (13, 2A), or its own for a region. |
| `location.department.name` | string | null |  |
| `location.region` | object | null | The region as Leboncoin files it (its former regions: Aquitaine, Rhône-Alpes). |
| `location.region.id` | string | Leboncoin's id: the department's number (13, 2A), or its own for a region. |
| `location.region.name` | string | null |  |
| `location.country_code` | string | null | ISO 3166-1 alpha-2. |
| `location.latitude` | number | null |  |
| `location.longitude` | number | null |  |
| `location.precision` | `street_number`, `street`, `district`, `city`, null | What the point stands for, as Leboncoin says; null when it does not say. |
| `location.from_address` | boolean | The seller gave an address; otherwise only a city, and the point stands for the city. |
| `seller` | object |  |
| `seller.type` | `private`, `pro` |  |
| `seller.id` | string | null | Leboncoin's user id. |
| `seller.name` | string | null | The seller's name as the listing shows it: a pseudonym, or the shop's name. |
| `seller.store_id` | string | null | The seller's store on Leboncoin (private sellers have one too). |
| `seller.siren` | string | null | French company number |
| `seller.activity_sector` | string | null | Leboncoin's id of a professional seller's sector. |
| `seller.no_salesmen` | boolean | The seller refuses canvassing. |
| `seller.fees_url` | string | null (uri) | A professional's page of fees (estate agents' scales). |
| `attributes` | array | Every attribute Leboncoin gives the listing, in its order and under its own key: the ones the page shows (brand, mileage, rooms, energy rating...), with their French labels, and the others (the seller's rating_score and rating_count, the car's price positioning...). Nothing a category adds is lost. |
| `attributes[].key` | string |  |
| `attributes[].label` | string | null | The French label the page shows, null for one it does not show. |
| `attributes[].value` | string | null |  |
| `attributes[].value_label` | string | null |  |
| `attributes[].values` | array of string | Every value of a list (equipment |
| `attributes[].values_label` | array of string | null |  |
| `calendar` | object | null | Holiday rentals only, null otherwise; the periods the seller set, open or closed, each with its price. |
| `calendar.min_price` | object | null | The lowest price of the calendar. |
| `calendar.min_price.amount` | number |  |
| `calendar.min_price.currency` | `"EUR"` | ISO 4217. |
| `calendar.periods` | array |  |
| `calendar.periods[].status` | string | null | open or closed. |
| `calendar.periods[].start_date` | string | null (date) |  |
| `calendar.periods[].end_date` | string | null (date) |  |
| `calendar.periods[].price` | object | null | The price the seller set for the period; null for a closed one. |
| `calendar.periods[].price.amount` | number |  |
| `calendar.periods[].price.currency` | `"EUR"` | ISO 4217. |
| `ids` | object | Every id Leboncoin gives with the listing. |
| `ids.listing_id` | string |  |
| `ids.user_id` | string | null |  |
| `ids.store_id` | string | null |  |
| `favorites` | integer | null | How many people saved the listing to their favorites, as Leboncoin counts them; given by a listing read alone, never by a search. |
| `source_url` | string (uri) | The listing's page on leboncoin.fr these values were read from. |
| `observed_at` | string (date-time) | When they were read |

Example:

```json
{
  "object": "listing",
  "id": "3000000001",
  "featured": false,
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3000000001",
  "title": "Appartement 3 pièces 64 m²",
  "description": "Lumineux, proche métro.\nLibre au 1er décembre.",
  "category": {
    "id": "9",
    "name": "Ventes immobilières"
  },
  "ad_type": "offer",
  "status": "active",
  "price": {
    "amount": 289000,
    "currency": "EUR"
  },
  "buyer_fee": null,
  "shipping": [],
  "published_at": "2026-10-21T07:14:00Z",
  "republished_at": "2026-11-02T08:30:12Z",
  "expires_at": "2027-01-01T08:30:12Z",
  "has_phone": true,
  "is_boosted": false,
  "paid_options": {
    "urgent": false,
    "gallery": false,
    "photosup": false,
    "sub_toplist": false,
    "continuous_top_ads": false,
    "highlight": false,
    "booster": false,
    "has_option": false
  },
  "photos": [
    {
      "url": "https://img.leboncoin.fr/api/v1/lbcpb1/images/00/00/00/example.jpg?rule=ad-large",
      "is_floor_plan": false
    }
  ],
  "photo_count": 1,
  "videos": [],
  "location": {
    "city": "Lyon",
    "postal_code": "69003",
    "district": null,
    "department": {
      "id": "69",
      "name": "Rhône"
    },
    "region": {
      "id": "22",
      "name": "Rhône-Alpes"
    },
    "country_code": "FR",
    "latitude": 45.75,
    "longitude": 4.85,
    "precision": null,
    "from_address": false
  },
  "seller": {
    "type": "pro",
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "Acme Immobilier",
    "store_id": "1000001",
    "siren": "000000000",
    "activity_sector": "2",
    "no_salesmen": true,
    "fees_url": null
  },
  "attributes": [
    {
      "key": "real_estate_type",
      "label": "Type de bien",
      "value": "2",
      "value_label": "Appartement",
      "values": [
        "2"
      ],
      "values_label": null
    },
    {
      "key": "square",
      "label": "Surface habitable",
      "value": "64",
      "value_label": "64 m²",
      "values": [
        "64"
      ],
      "values_label": null
    },
    {
      "key": "energy_rate",
      "label": "Classe énergie",
      "value": "c",
      "value_label": "C",
      "values": [
        "c"
      ],
      "values_label": null
    }
  ],
  "calendar": null,
  "ids": {
    "listing_id": "3000000001",
    "user_id": "00000000-0000-0000-0000-000000000000",
    "store_id": "1000001"
  },
  "favorites": 12,
  "source_url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3000000001",
  "observed_at": "2026-11-02T09:00:00Z"
}
```

## Price



## Errors

| Code | Status | Retry | Message |
|---|---|---|---|
| `invalid_listing` | 422 | no | The value is neither a leboncoin.fr listing id nor a listing URL. |
| `listing_gone` | 404 | no | This listing is no longer online: it expired, was deleted or sold, or never existed (Leboncoin answers all of these the same way and keeps nothing of it). Not charged. |
| `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 Scraper: one listing a call, whole, with the same fields as a listing of leboncoin/listings/search, and how many people saved it (`favorites`).

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