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.0When 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.
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" } }'
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
listingstringrequiredRecord
Each record of results, in the envelope every call returns (Run an operation).
objectstringidstringfeaturedbooleanurlstringtitlestringdescriptionstringcategory.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_idstringfavoritesintegersource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_listing | 422 | The value is neither a leboncoin.fr listing id nor a listing URL. |
listing_gone | 404 | 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 | 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
3 credits a call. A failed call is free. What a credit costs on each plan: Credits and pricing.
Changelog
1.0.02026-11-10favorites).