Skip to content
Leboncoin

Get a listing

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

leboncoin/listings/get3 credits a callv1.0.0

When to use it

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.

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.
3 credits 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/get",
    "options": {
      "listing": "https://www.leboncoin.fr/ad/ventes_immobilieres/3000000001"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_rdeiwdher6vll2bafgk5mlbzuu",
  "livemode": true,
  "source": "leboncoin",
  "operation": "listings/get",
  "version": "1.0.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/leboncoin/listings/get",
  "options": {
    "listing": "https://www.leboncoin.fr/ad/ventes_immobilieres/3000000001"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "leboncoin",
    "operation": "listings/get",
    "options": {
      "listing": "https://www.leboncoin.fr/ad/ventes_immobilieres/3000000001",
      "url": "https://www.leboncoin.fr/recherche?category=9&locations=Lyon__45.76_4.83_7308_5000__d69&sort=time&order=desc&page=2",
      "cursor": "{\"ids_to_display\":[],\"es_pivot\":\"0.0|1793565058000|3000000035\",\"reranker_offset\":35,\"total\":5335,\"page_number\":1}"
    }
  },
  "cost": {
    "credits": 3
  },
  "results": [
    {
      "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"
    }
  ]
}

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
The kind of record: a listing, whichever site it comes from.
idstring
Leboncoin's listing id; repeated in ids.listing_id.
featuredboolean
The listing has Leboncoin's "À la une" option (paid): searches show it with that badge, and at their top when sorted by date.
urlstring
The listing on leboncoin.fr.
titlestring
descriptionstring
The seller's text, as written (line breaks kept).
category.idstring
Leboncoin's category id: 2 cars, 9 property sales, 10 rentals...
category.namestring
As Leboncoin names it
ad_typestring
An offer (selling, renting, hiring) or a demand (looking for).
statusstring
Leboncoin's status of the listing: active on a search page.
price.amountfloat
price.currencystring
ISO 4217.
buyer_fee.amountfloat
buyer_fee.currencystring
ISO 4217.
shippinglist
The ways the seller ships, each with its price; empty when the listing is hand to hand only.
published_atdate
The first publication, UTC.
republished_atdate
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_atdate
When the listing goes offline unless renewed, UTC; null when Leboncoin does not say.
has_phoneboolean
The listing shows a "Voir le numéro" button: leboncoin/phones/get reads its number.
is_boostedboolean
Leboncoin's own flag for a listing pushed by an option.
paid_options.urgentboolean
paid_options.galleryboolean
paid_options.photosupboolean
paid_options.sub_toplistboolean
paid_options.continuous_top_adsboolean
paid_options.highlightboolean
paid_options.boosterboolean
paid_options.has_optionboolean
photoslist
Every photo, in the listing's order, at the largest size Leboncoin serves.
photo_countinteger
videoslist
location.citystring
location.postal_codestring
location.districtstring
The part of the city, when the seller gave an address: Golfe Juan in Vallauris.
location.department.idstring
Leboncoin's id: the department's number (13, 2A), or its own for a region.
location.department.namestring
location.region.idstring
Leboncoin's id: the department's number (13, 2A), or its own for a region.
location.region.namestring
location.country_codestring
ISO 3166-1 alpha-2.
location.latitudefloat
location.longitudefloat
location.precisionstring
What the point stands for, as Leboncoin says; null when it does not say.
location.from_addressboolean
The seller gave an address; otherwise only a city, and the point stands for the city.
seller.typestring
seller.idstring
Leboncoin's user id.
seller.namestring
The seller's name as the listing shows it: a pseudonym, or the shop's name.
seller.store_idstring
The seller's store on Leboncoin (private sellers have one too).
seller.sirenstring
French company number
seller.activity_sectorstring
Leboncoin's id of a professional seller's sector.
seller.no_salesmenboolean
The seller refuses canvassing.
seller.fees_urlstring
A professional's page of fees (estate agents' scales).
attributeslist
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.
calendar.min_price.amountfloat
calendar.min_price.currencystring
ISO 4217.
calendar.periodslist
ids.listing_idstring
ids.user_idstring
ids.store_idstring
favoritesinteger
How many people saved the listing to their favorites, as Leboncoin counts them; given by a listing read alone, never by a search.
source_urlstring
The listing's page on leboncoin.fr 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.
listing_gone404This 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_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

3 credits 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 Scraper: one listing a call, whole, with the same fields as a listing of leboncoin/listings/search, and how many people saved it (favorites).