Get a vehicle listing
One complete LaCentrale vehicle listing: description, specifications, equipment, photos, history preview, warranties and public seller details.
lacentrale/listings/get4 credits a callv1.0.0When to use it
You have a LaCentrale listing URL, reference (E120356577) or numeric id (69120356577), for example from lacentrale/listings/search, and need the complete listing. Includes seller comments, all equipment and options, electric specifications with statistical battery-health estimates, warranty terms, maintenance estimates, history preview, gallery and seller details with public phones. A search result does not contain these details. One listing per call; no pagination. The site supplies French labels and text. For the listing's warranty duration, use warranty.months; programme descriptions may advertise a higher maximum, and manufacturer_months/original_months do not establish remaining coverage. Battery health is a statistical estimate, never a measured certificate; seller comments can separately mention a battery test. No account is needed.
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/get", "options": { "listing": "E100000001" } }'
An example answer, from the contract. Run it on your own input with your API key.
{ "object": "run", "id": "run_rmtwltyvenzpxjss66yjwf3lxq", "livemode": true, "source": "lacentrale", "operation": "listings/get", "version": "1.0.0", "schema_url": "https://api.lobstr.io/v2/catalog/lacentrale/listings/get", "options": { "listing": "E100000001" }, "fields": null, "status": "succeeded", "count": 1, "has_more": false, "next": null, "cost": { "credits": 4 }, "results": [ { "object": "listing", "id": "E100000001", "url": "https://www.lacentrale.fr/auto-occasion-annonce-69100000001.html", "title": "BMW X1 F48 phase 2", "description": "Well-maintained vehicle. Full service history available.", "status": "online", "price": { "amount": 21690, "currency": "EUR" }, "is_vat_recoverable": false, "deal_rating": "good_deal", "estimated_value": { "amount": 22779, "currency": "EUR" }, "valuation_confidence": 5, "price_history": { "initial": { "amount": 21690, "currency": "EUR" }, "current": { "amount": 21690, "currency": "EUR" }, "prices": [ { "amount": 21690, "currency": "EUR" }, { "amount": 21690, "currency": "EUR" } ], "change_percent": 0, "has_dropped": false, "is_initial_crossed_out": false, "dated_prices": [] }, "age_days": 0, "is_age_capped": false, "publication_ends_at": "2999-01-01T00:00:00Z", "vehicle": { "make": "BMW", "model": "X1", "commercial_name": "X1", "version": "(F48) (2) XDRIVE18D XLINE BVA8", "exterior_color": "Mineralgrau", "interior_color": "Noir", "first_registration_date": "2019-12-30", "doors": 5, "seats": 5, "engine_capacity_cm3": 1995, "power_hp": 150, "fiscal_power_cv": 8, "length_mm": 4450, "boot_capacity_l": 505, "owners_count": 3, "is_imported": null, "detailed_model": "BMW X1 F48 phase 2", "motorization": "2.0 XDRIVE18D 150", "trim": "XLINE", "is_new_generation": false, "registration_type": null, "height_mm": 1600, "width_mm": 1820, "weight_kg": 1540, "power_kw": null, "family": "auto", "category": "tous_chemins", "energy": "diesel", "gearbox": "automatique", "year": 2019, "mileage_km": 102661, "is_first_hand": false, "average_mileage_km": 105420, "mileage_rating": "medium_mileage", "equipment_level": 2, "test_standard": "NEDC", "original_new_price": { "amount": 46500, "currency": "EUR" }, "consumption": { "highway_l_per_100km": 5.7, "road_l_per_100km": 4.4, "city_l_per_100km": 5.1, "combined_l_per_100km": null, "low_l_per_100km": null, "medium_l_per_100km": null, "high_l_per_100km": null, "extra_high_l_per_100km": null, "is_reliable": true }, "emissions": { "co2_g_per_km": 114, "is_reliable": true, "eco_bonus_malus": { "amount": 0, "currency": "EUR" }, "euro_standard": "EURO6", "critair_class": "2", "has_conversion_allowance": false }, "battery": { "capacity_kwh": null, "consumption_kwh_per_100km": null, "current_a": null, "voltage_v": null, "range_km": null, "is_plug_in": null, "is_included_in_price": null, "statistical_health": null } }, "equipment": [ { "category": "Sécurité", "name": "ESP" }, { "category": "Sécurité", "name": "Airbags rideaux" } ], "options": [], "packs": [ "Pack Advanced Full LED" ], "equipment_highlights": [ "toit ouvrant panoramique", "phares av. de jour à LED" ], "equipment_by_ai": [ "toit ouvrant panoramique", "phares av. de jour à LED" ], "highlights": [ { "label": "Véhicule certifié", "value": "SPOTICAR PREMIUM" }, { "label": "Engagement", "value": "Satisfait ou remboursé" } ], "warranty": { "details": [ { "label": "Garantie", "value": "12 mois", "description": null } ], "months": 12, "label": "SPOTICAR PREMIUM", "description": "- Garantie commerciale jusqu'à 24 mois et kilométrage illimité- Véhicule révisé et contrôlé- Assistance 24h/24 et 7j/7 en Europe- Satisfait ou remboursé- Essai du véhicule sans engagement- Solutions de financement- Reprise de véhicule- Conseils et accompagnement personnalisés", "summary": "- Garantie 12 ou 24 mois- Véhicule révisé et contrôlé- Assistance 24h/24", "is_partner": true, "manufacturer_months": 24, "manufacturer_max_km": null, "manufacturer_ends_on": null, "original_months": 24, "original_max_km": 999999, "certification": { "name": "SPOTICAR PREMIUM", "label": "Garantie certifiée", "value": "spoticar premium", "logo_url": "https://www.lacentrale.fr/static/fragment-classified-detail-fragments/media/spoticar_premium_V3.948461cb.svg", "description": [ "Garantie commerciale jusqu'à 24 mois et kilométrage illimité", "Véhicule révisé et contrôlé", "Assistance 24h/24 et 7j/7 en Europe", "Satisfait ou remboursé", "Essai du véhicule sans engagement", "Solutions de financement", "Reprise de véhicule", "Conseils et accompagnement personnalisés" ], "url": "https://lacentrale.fr/labels-constructeurs/spoticar-premium", "is_partner": true } }, "history": { "has_report": true, "has_claims": false, "has_professional_use": true, "has_atypical_operations": false, "is_imported": false, "report_url": null }, "maintenance": { "has_schedule": true, "status": "ok", "count": 2, "message": "2 entretien(s) à réaliser sur cette période", "period": "Mai 2026 à Mai 2027", "period_from": "2026-05", "period_to": "2027-05", "before": [ { "name": "Plaquettes de frein arriere", "reason": "Changement plaquettes de frein arriere", "month": "2026-04", "mileage_km": 97000, "distance_since_due_km": 5661, "months_since_due": 6.7932, "is_next": false, "interval": 97000, "interval_unit": "km", "occurrence": 1, "labour_hours": 0.75, "status": "unknown", "labour_cost": { "amount": 72.51, "currency": "EUR" }, "parts_cost": { "amount": 150.88, "currency": "EUR" }, "total_cost": { "amount": 220, "currency": "EUR" }, "parts": [], "oil_cost": null } ], "after": [] }, "declared_repairs": [], "financing": { "has_loan": false, "has_lease": false, "loan_monthly_price": null, "lease_monthly_price": null, "loan_name": null, "lease_name": null }, "photos": [ { "id": "photo-001", "url": "https://example.com/vehicle.jpg", "mobile_url": "https://example.com/vehicle-mobile.jpg", "original_url": null, "mobile_original_url": null, "video_url": null, "type": "standard", "category": "front_3_4_l", "group_id": "outside", "score": 100 } ], "photo_groups": [ { "id": "outside", "label": "Extérieur", "first_photo_index": 0 } ], "seller": { "type": "pro", "name": "Acme Motors", "kind": "concessionnaire", "kind_label": "Concessionnaire", "company_created_at": "2010-12-22T00:00:00Z", "is_verified": true, "is_broker": false, "is_distance_seller": false, "listings_count": 100, "url": "https://example.com/dealer", "address": { "street": "1 Example Street", "postal_code": "75001", "city": "Paris", "country": "FR", "latitude": 48.86, "longitude": 2.34 }, "has_phone": true, "has_email": true, "has_whatsapp": true, "whatsapp_phone": null, "phones": [ { "number": "+33123456789", "as_written": "0123456789" } ], "services": [], "presentation": "Used vehicle dealership.", "logo_url": "https://example.com/logo.png", "website_url": "https://example.com", "banners": [], "contacts": [], "opening_status": "Ouvert", "has_opening_hours": true, "opening_hours": [ { "day": "monday", "hours": [ "09h00-12h00", "14h00-18h00" ] }, { "day": "tuesday", "hours": [ "09h00-12h00", "14h00-18h00" ] }, { "day": "wednesday", "hours": [ "09h00-12h00", "14h00-18h00" ] }, { "day": "thursday", "hours": [ "09h00-12h00", "14h00-18h00" ] }, { "day": "friday", "hours": [ "09h00-12h00", "14h00-18h00" ] }, { "day": "saturday", "hours": [ "09h00-12h00", "14h00-18h00" ] }, { "day": "sunday", "hours": [ "Fermé" ] } ], "rating": { "value": 4.2, "scale": 5, "count": 1280 }, "reviews_url": null, "reviews": [] }, "location": { "department": "62", "postal_code": "62400", "is_listing_location": false }, "valuation_url": null, "technical_specifications_url": null, "ids": { "listing_id": "E100000001", "url_id": "69100000001", "seller_reference": "DEMO-001", "customer_reference": "C000001", "owner_correlation_id": "C000001", "version_id": "25888249", "warranty_id": "00c1467f", "vehicle_id": "P_C045126_pe62c7_PT40492", "financing_siret": null }, "source_url": "https://www.lacentrale.fr/auto-occasion-annonce-69100000001.html", "observed_at": "2026-11-13T14:00:00Z" } ] }
Options
listingstringrequiredRecord
Each record of results, in the envelope every call returns (Run an operation).
objectstringidstringurlstringtitlestringdescriptionstringstatusstringprice.amountfloatprice.currencystringis_vat_recoverablebooleandeal_ratingstringestimated_value.amountfloatestimated_value.currencystringvaluation_confidenceintegerprice_history.initial.amountfloatprice_history.initial.currencystringprice_history.current.amountfloatprice_history.current.currencystringprice_history.priceslistprice_history.change_percentfloatprice_history.has_droppedbooleanprice_history.is_initial_crossed_outbooleanprice_history.dated_priceslistage_daysintegeris_age_cappedbooleanpublication_ends_atdatevehicle.makestringvehicle.modelstringvehicle.commercial_namestringvehicle.versionstringvehicle.exterior_colorstringvehicle.interior_colorstringvehicle.first_registration_datestringvehicle.doorsintegervehicle.seatsintegervehicle.engine_capacity_cm3integervehicle.power_hpintegervehicle.fiscal_power_cvintegervehicle.length_mmintegervehicle.boot_capacity_lintegervehicle.owners_countintegervehicle.is_importedbooleanvehicle.detailed_modelstringvehicle.motorizationstringvehicle.trimstringvehicle.is_new_generationbooleanvehicle.registration_typestringvehicle.height_mmintegervehicle.width_mmintegervehicle.weight_kgintegervehicle.power_kwintegervehicle.familystringvehicle.categorystringvehicle.energystringvehicle.gearboxstringvehicle.yearintegervehicle.mileage_kmintegervehicle.is_first_handbooleanvehicle.average_mileage_kmintegervehicle.mileage_ratingstringvehicle.equipment_levelintegervehicle.test_standardstringvehicle.original_new_price.amountfloatvehicle.original_new_price.currencystringvehicle.consumption.highway_l_per_100kmfloatvehicle.consumption.road_l_per_100kmfloatvehicle.consumption.city_l_per_100kmfloatvehicle.consumption.combined_l_per_100kmfloatvehicle.consumption.low_l_per_100kmintegervehicle.consumption.medium_l_per_100kmfloatvehicle.consumption.high_l_per_100kmfloatvehicle.consumption.extra_high_l_per_100kmfloatvehicle.consumption.is_reliablebooleanvehicle.emissions.co2_g_per_kmintegervehicle.emissions.is_reliablebooleanvehicle.emissions.eco_bonus_malus.amountfloatvehicle.emissions.eco_bonus_malus.currencystringvehicle.emissions.euro_standardstringvehicle.emissions.critair_classstringvehicle.emissions.has_conversion_allowancebooleanvehicle.battery.capacity_kwhintegervehicle.battery.consumption_kwh_per_100kmfloatvehicle.battery.current_afloatvehicle.battery.voltage_vfloatvehicle.battery.range_kmintegervehicle.battery.is_plug_inbooleanvehicle.battery.is_included_in_pricebooleanvehicle.battery.statistical_health.estimated_percentintegervehicle.battery.statistical_health.lower_percentintegervehicle.battery.statistical_health.upper_percentintegervehicle.battery.statistical_health.is_near_newbooleanvehicle.battery.statistical_health.is_rangebooleanvehicle.battery.statistical_health.displayed_percentintegervehicle.battery.statistical_health.badgestringequipmentlistoptionslistpackslistequipment_highlightslistequipment_by_ailisthighlightslistwarranty.detailslistwarranty.monthsintegerwarranty.labelstringwarranty.descriptionstringwarranty.summarystringwarranty.is_partnerbooleanwarranty.manufacturer_monthsintegerwarranty.manufacturer_max_kmintegerwarranty.manufacturer_ends_onstringwarranty.original_monthsintegerwarranty.original_max_kmintegerwarranty.certification.namestringwarranty.certification.labelstringwarranty.certification.valuestringwarranty.certification.logo_urlstringwarranty.certification.descriptionlistwarranty.certification.urlstringwarranty.certification.is_partnerbooleanhistory.has_reportbooleanhistory.has_claimsbooleanhistory.has_professional_usebooleanhistory.has_atypical_operationsbooleanhistory.is_importedbooleanhistory.report_urlstringmaintenance.has_schedulebooleanmaintenance.statusstringmaintenance.countintegermaintenance.messagestringmaintenance.periodstringmaintenance.period_fromstringmaintenance.period_tostringmaintenance.beforelistmaintenance.afterlistdeclared_repairslistfinancing.has_loanbooleanfinancing.has_leasebooleanfinancing.loan_monthly_price.amountfloatfinancing.loan_monthly_price.currencystringfinancing.lease_monthly_price.amountfloatfinancing.lease_monthly_price.currencystringfinancing.loan_namestringfinancing.lease_namestringphotoslistphoto_groupslistseller.typestringseller.namestringseller.kindstringseller.kind_labelstringseller.company_created_atdateseller.is_verifiedbooleanseller.is_brokerbooleanseller.is_distance_sellerbooleanseller.listings_countintegerseller.urlstringseller.address.streetstringseller.address.postal_codestringseller.address.citystringseller.address.countrystringseller.address.latitudefloatseller.address.longitudefloatseller.has_phonebooleanseller.has_emailbooleanseller.has_whatsappbooleanseller.whatsapp_phone.numberstringseller.whatsapp_phone.as_writtenstringseller.phoneslistseller.serviceslistseller.presentationstringseller.logo_urlstringseller.website_urlstringseller.bannerslistseller.contactslistseller.opening_statusstringseller.has_opening_hoursbooleanseller.opening_hourslistseller.rating.valuefloatseller.rating.scaleintegerseller.rating.countintegerseller.reviews_urlstringseller.reviewslistlocation.departmentstringlocation.postal_codestringlocation.is_listing_locationbooleanvaluation_urlstringtechnical_specifications_urlstringids.listing_idstringids.url_idstringids.seller_referencestringids.customer_referencestringids.owner_correlation_idstringids.version_idstringids.warranty_idstringids.vehicle_idstringids.financing_siretstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
ip_blocked | 503 | LaCentrale refused the attempted IPs. Retry later; failed calls are free. Retryable. |
invalid_listing | 400 | Pass a LaCentrale listing reference, numeric id or listing URL. |
listing_gone | 404 | LaCentrale says this listing is unavailable or does not exist. |
blocked | 503 | LaCentrale refused this request. Retry later; failed calls are free. Retryable. |
site_unavailable | 503 | LaCentrale could not serve the listing. Retry later. Retryable. |
unexpected_answer | 502 | LaCentrale returned an unreadable or incomplete listing. |
Price
4 credits per successful call returning one listing. Failed calls, including unavailable listings, are free. What a credit costs on each plan: Credits and pricing.
Changelog
1.0.02026-11-13