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.0When 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.
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" } }'
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
urlstringrequiredpage 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.cursorstringnext 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).
objectstringidstringpositionintegerfeaturedbooleanurlstringtitlestringdescriptionstringcategory.idstringcategory.namestringad_typestringstatusstringprice.amountfloatprice.currencystringbuyer_fee.amountfloatbuyer_fee.currencystringshippinglistpublished_atdaterepublished_atdateexpires_atdatehas_phonebooleanis_boostedbooleanpaid_options.urgentbooleanpaid_options.gallerybooleanpaid_options.photosupbooleanpaid_options.sub_toplistbooleanpaid_options.continuous_top_adsbooleanpaid_options.highlightbooleanpaid_options.boosterbooleanpaid_options.has_optionbooleanphotoslistphoto_countintegervideoslistlocation.citystringlocation.postal_codestringlocation.districtstringlocation.department.idstringlocation.department.namestringlocation.region.idstringlocation.region.namestringlocation.country_codestringlocation.latitudefloatlocation.longitudefloatlocation.precisionstringlocation.from_addressbooleanseller.typestringseller.idstringseller.namestringseller.store_idstringseller.sirenstringseller.activity_sectorstringseller.no_salesmenbooleanseller.fees_urlstringattributeslistcalendar.min_price.amountfloatcalendar.min_price.currencystringcalendar.periodslistids.listing_idstringids.user_idstringids.store_idstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_url | 422 | This URL is not a leboncoin.fr search this operation reads. |
invalid_cursor | 422 | This cursor was not given by an answer; send next from the last answer as it is. |
site_challenge | 503 | Leboncoin asked to prove a person is there; retry in a minute (not charged). Retryable. |
site_unavailable | 503 | Leboncoin did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | Leboncoin 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-13next 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-13since 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-02next carries the page's cursor, so a search read page by page neither skips nor repeats a listing.