Skip to content
Leboncoin

Search listings

One page of a leboncoin.fr search, 35 listings at most, exactly as the page shows them, descriptions included.

leboncoin/listings/search100 credits a callv2.1.0

When to use it

You need the listings of a leboncoin.fr search: title, description, price, place, seller, photos, every attribute (property, vehicle, job...), and whether the seller shows a phone (has_phone). Set the search up on leboncoin.fr (category, place, filters, sort), then pass its URL. For a seller's number, call leboncoin/phones/get on a listing with has_phone.

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
A leboncoin.fr search, exactly as the browser shows it once the search is set up (category, place, filters, keywords, sort), its page the page to start at (page=2 is the second page).
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor).
100 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/search",
    "options": {
      "url": "https://www.leboncoin.fr/recherche?category=9&locations=Lyon__45.76_4.83_7308_5000__d69&sort=time&order=desc"
    }
  }'
2Response

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

{
  "object": "run",
  "id": "run_jdcbrm3rrntchrzax4eu5tkqgy",
  "livemode": true,
  "source": "leboncoin",
  "operation": "listings/search",
  "version": "2.1.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/leboncoin/listings/search",
  "options": {
    "url": "https://www.leboncoin.fr/recherche?category=9&locations=Lyon__45.76_4.83_7308_5000__d69&sort=time&order=desc"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "leboncoin",
    "operation": "listings/search",
    "options": {
      "url": "https://www.leboncoin.fr/recherche?category=9&locations=Lyon__45.76_4.83_7308_5000__d69&sort=time&order=desc",
      "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5"
    }
  },
  "cost": {
    "credits": 100
  },
  "results": [
    {
      "object": "listing",
      "id": "3000000001",
      "position": 1,
      "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"
      },
      "source_url": "https://www.leboncoin.fr/recherche?category=9&locations=Lyon__45.76_4.83_7308_5000__d69&sort=time&order=desc",
      "observed_at": "2026-11-02T09:00:00Z"
    }
  ]
}

Options

urlstringrequired
A leboncoin.fr search, exactly as the browser shows it once the search is set up (category, place, filters, keywords, sort), its page the page to start at (page=2 is the second page). Sort by date, newest first, with sort=time&order=desc ("Plus récentes"). Every filter of the site is read; a parameter Leboncoin does not filter on is refused, never ignored.
cursorstring
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor). Leave it out to start at the URL's page. It goes on where the previous page ended, as Leboncoin's own next page does: a page reached by its URL alone is read as a link to it shows it, and Leboncoin may skip the listings that the featured copies of the page before pushed down.

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.
positioninteger
Its place among the cards the search shows, across pages (35 a page): 36 is the first of page 2. A featured copy has a place of its own, as on the page.
featuredboolean
Shown with Leboncoin's "À la une" badge at this place (a paid option). Sorted by date, Leboncoin also puts such listings at the top of the page: the same listing then comes twice, featured at the top and in its own place by date, as the page shows it.
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
source_urlstring
The search page these values were read from, its page included.
observed_atdate
When they were read

Errors

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

CodeStatusWhat it means
invalid_url422This URL is not a leboncoin.fr search this operation reads.
invalid_cursor422This cursor was not given by an answer; send next from the last answer as it is.
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

100 credits a call, whatever the page holds: a short last page costs a whole call. An empty page and a failed call are free. What a credit costs on each plan: Credits and pricing.

Changelog

2.1.02026-11-13
next keeps the search as it was written and goes on with cursor, opaque, as every paged operation of the API (Google's page tokens): copy next as before. The URL is no longer rewritten with the next page; its page still starts at any page.
2.0.02026-11-13
since is gone: Leboncoin has no date filter, it was ours, and a page is now served exactly as Leboncoin serves it. To keep only the newest listings, a batch filters on republished_at and stops early on a search sorted by date, newest first.
1.0.02026-11-02
First version on the API v2: one page of a leboncoin.fr search as the page shows it, featured copies in their place, with every description and attribute; next carries the page's cursor, so a search read page by page neither skips nor repeats a listing.