Search vehicle listings
One LaCentrale page: up to 23 vehicles with specifications and public seller phones, for 23 credits per nonempty call even when limit returns fewer records.
lacentrale/listings/search23 credits a callv2.0.0When to use it
You need vehicles advertised on LaCentrale: cars, utility vehicles or motorcycles, with their price, mileage, fuel, gearbox, seller and public phones. Set filters and sorting on lacentrale.fr, then pass the /listing URL. Follow next unchanged for more results. The vehicle listing reference is id; ids.customer_reference identifies the seller. Seller phones can belong to professionals or private owners and are present only when published. A continuation keeps the first page's ranking context, which is not a geographic filter: a search remains nationwide unless its URL filters location.
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": "lacentrale", "operation": "listings/search", "options": { "url": "https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc" } }'
An example answer, from the contract. Run it on your own input with your API key.
{ "object": "run", "id": "run_rpkhebjlqkd4gq4p2ngezxejdi", "livemode": true, "source": "lacentrale", "operation": "listings/search", "version": "2.0.0", "schema_url": "https://api.lobstr.io/v2/catalog/lacentrale/listings/search", "options": { "url": "https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc" }, "fields": null, "status": "succeeded", "count": 1, "has_more": true, "next": { "source": "lacentrale", "operation": "listings/search", "options": { "url": "https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc", "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5" } }, "cost": { "credits": 23 }, "results": [ { "object": "listing", "id": "E120356577", "position": 1, "url": "https://www.lacentrale.fr/auto-occasion-annonce-69120356577.html", "title": "BMW X1 F48", "price": { "amount": 21690, "currency": "EUR" }, "ranking_score": 630.24457, "vehicle": { "make": "BMW", "model": "X1", "commercial_name": "X1 F48", "detailed_model": "BMW X1 F48 phase 2", "version": "(F48) (2) XDRIVE18D XLINE BVA8", "trim": "XLINE", "motorization": "2.0 XDRIVE18D 150", "category": "SUV_4X4_CROSSOVER", "family": "AUTO", "energy": "DIESEL", "gearbox": "AUTO", "year": 2019, "mileage_km": 102661, "doors": 5, "exterior_color": "Mineralgrau" }, "is_new_listing": true, "is_new_vehicle": false, "deal_rating": "GOOD_DEAL", "has_vehicle_history": true, "published_date": "2026-11-13", "updated_at": "2026-11-13T10:11:23Z", "recent_price_drop_until": null, "location": { "country": "FR", "department": "62", "distance_km": null }, "seller": { "id": "C045126", "type": "pro", "kind": "CONCESSIONNAIRE", "name": "PEUGEOT Béthune - SOFIDA auto", "phones": [ { "number": "+33352690150", "as_written": "0352690150" } ] }, "photos": { "urls": [ "https://pictures.lacentrale.fr/classifieds/E120356577_STANDARD_0.jpg?format=webp&lastUpdated=1794564683&size=352x264&watermark=lc&signature=[REDACTED]", "https://pictures.lacentrale.fr/classifieds/E120356577_STANDARD_0.jpg?format=webp&lastUpdated=1794564683&size=285x214&watermark=lc&signature=[REDACTED]", "https://pictures.lacentrale.fr/classifieds/E120356577_STANDARD_1.jpg?format=webp&lastUpdated=1794564683&size=140x105&watermark=lc&signature=[REDACTED]", "https://pictures.lacentrale.fr/classifieds/E120356577_STANDARD_2.jpg?format=webp&lastUpdated=1794564683&size=140x105&watermark=lc&signature=[REDACTED]" ], "count": 33, "updated_at": "2026-11-13T10:11:23Z", "has_exterior_360": false, "has_photosphere": false }, "warranty": { "months": 12, "manufacturer_until": null, "has_extension": null }, "financing": null, "delivery": null, "publication_options": [ "CALLTRACKING", "PHOTO_360", "PHOTO_LISTING", "PHOTO_WEB", "WEB_IMMEDIAT", "DELIVERY", "STRENGTHS", "MULTI_PHOTOS" ], "ids": { "listing_id": "E120356577", "url_id": "69120356577", "customer_reference": "C045126", "owner_correlation_id": "C045126" }, "source_url": "https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc", "observed_at": "2026-11-13T10:50:00Z" } ] }
Options
urlstringrequiredcursorstringRecord
Each record of results, in the envelope every call returns (Run an operation).
objectstringidstringpositionintegerurlstringtitlestringprice.amountfloatprice.currencystringranking_scorefloatvehicle.makestringvehicle.modelstringvehicle.commercial_namestringvehicle.detailed_modelstringvehicle.versionstringvehicle.trimstringvehicle.motorizationstringvehicle.categorystringvehicle.familystringvehicle.energystringvehicle.gearboxstringvehicle.yearintegervehicle.mileage_kmintegervehicle.doorsintegervehicle.exterior_colorstringis_new_listingbooleanis_new_vehiclebooleandeal_ratingstringhas_vehicle_historybooleanpublished_datestringupdated_atdaterecent_price_drop_untildatelocation.countrystringlocation.departmentstringlocation.distance_kmfloatseller.idstringseller.typestringseller.kindstringseller.namestringseller.phoneslistphotos.urlslistphotos.countintegerphotos.updated_atdatephotos.has_exterior_360booleanphotos.has_photospherebooleanwarranty.monthsintegerwarranty.manufacturer_untilstringwarranty.has_extensionbooleanfinancing.idstringfinancing.valid_untildatefinancing.loan_monthly_price.amountfloatfinancing.loan_monthly_price.currencystringfinancing.lease_monthly_price.amountfloatfinancing.lease_monthly_price.currencystringdelivery.availablebooleandelivery.max_distance_kmfloatdelivery.priceslistpublication_optionslistids.listing_idstringids.url_idstringids.customer_referencestringids.owner_correlation_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 is not a supported LaCentrale listing URL, or a filter or page is invalid. |
invalid_search | 422 | Pass the continuation context unchanged from next, or omit search to start a new search. |
site_challenge | 503 | LaCentrale’s anti-bot refused the request; retry in a minute (not charged). Retryable. |
site_unavailable | 503 | LaCentrale is unavailable; retry later (not charged). Retryable. |
unexpected_answer | 424 | LaCentrale answered in a shape we do not read yet; we are told and fix it (not charged). |
Price
23 credits per call, including a short last page. Empty answers and failed calls are free. What a credit costs on each plan: Credits and pricing.
Changelog
2.0.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. search is no longer an option: the ranking context travels inside the cursor. The URL's page still starts at any page.1.0.02026-11-13