La Centrale APIlacentrale.com ↗
Get min, max, average, and median used car prices from La Centrale listings. Filter by make, model, year, fuel type, gearbox, and horsepower.
What is the La Centrale API?
The La Centrale API exposes 1 endpoint — get_price_stats — that returns price statistics across used car listings on lacentrale.fr. A single call yields up to 12 response fields including prix_min, prix_max, prix_moyen, and a full annonces array with per-listing detail on mileage, version, motorization, and fuel type. Filters cover make, model, year, gearbox, fuel type, version substring, and DIN horsepower.
curl -X GET 'https://api.parse.bot/scraper/e516e6f8-069b-4a9b-bac4-ba75ceaae7c0/get_price_stats?annee=2020&boite=MANUELLE&marque=RENAULT&modele=CLIO&energie=ESSENCE&max_pages=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lacentrale-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: La Centrale price stats — compare fuel types and find deals."""
from parse_apis.la_centrale_car_price_statistics_api import (
LaCentrale, Energie, Boite, SearchFailed,
)
client = LaCentrale()
# Get price stats for Renault Clio 2020 petrol with manual gearbox.
stats = client.pricestatses.get(
marque="RENAULT", modele="CLIO", annee="2020",
energie=Energie.ESSENCE, boite=Boite.MANUELLE, max_pages=1,
)
print(f"Petrol manual: {stats.annonces_analysees} listings, median €{stats.prix_median}")
# Compare with diesel to see the price difference.
diesel_stats = client.pricestatses.get(
marque="RENAULT", modele="CLIO", annee="2020",
energie=Energie.DIESEL, max_pages=1,
)
print(f"Diesel: {diesel_stats.total_annonces} total, avg €{diesel_stats.prix_moyen}")
# Inspect individual listings from the result.
for listing in stats.annonces[:3]:
print(f" {listing.version} — €{listing.prix}, {listing.kilometrage} km, {listing.couleur}")
# Handle a search that may fail (e.g., unknown make/model combination).
try:
unknown = client.pricestatses.get(marque="ZZZZZ", modele="NOPE", max_pages=1)
print(f"Found {unknown.total_annonces} listings")
except SearchFailed as exc:
print(f"Search failed for {exc.marque}/{exc.modele}: {exc}")
print("exercised: pricestatses.get with Energie enum, Boite enum, listing attribute access, error handling")
Get price statistics for a given car configuration from La Centrale listings. Fetches listing pages and computes min, max, average, and median prices. Returns up to 20 sample listings with details. Supports filtering by make, model, year, fuel type, gearbox, version title, and DIN horsepower. Each page contains 23 listings; pagination is bounded by max_pages (default: all up to 50). Local filters (titre, puissance_din) are applied after fetching.
| Param | Type | Description |
|---|---|---|
| annee | string | Model year to filter by exact year (e.g., 2020). |
| boite | string | Gearbox type filter: MANUELLE or AUTOMATIQUE. |
| titre | string | Filter by version/title substring match (e.g., TCE 75 GENERATION). Applied locally after fetching listings. |
| marquerequired | string | Car make/brand in uppercase (e.g., RENAULT, PEUGEOT, BMW). |
| modelerequired | string | Car model in uppercase (e.g., CLIO, 308, SERIE 3). |
| energie | string | Fuel type filter: ESSENCE, DIESEL, ELECTRIQUE, HYBRIDE, or GPL. |
| max_pages | integer | Maximum number of pages to fetch (23 listings per page). 0 fetches all pages up to 50. |
| puissance_din | string | Filter by DIN horsepower extracted from motorization (e.g., 75, 100). Applied locally after fetching listings. |
{
"type": "object",
"fields": {
"annee": "string or null - Year filter applied",
"boite": "string or null - Gearbox filter applied",
"titre": "string or null - Title/version filter applied",
"marque": "string - Car make filter applied",
"modele": "string - Car model filter applied",
"energie": "string or null - Energy/fuel filter applied",
"annonces": "array of listing objects with prix, marque, modele, annee, energie, boite_vitesse, kilometrage, version, motorisation, categorie, couleur, reference",
"prix_max": "number or null - Maximum price in EUR",
"prix_min": "number or null - Minimum price in EUR",
"prix_moyen": "number or null - Average price in EUR",
"prix_median": "number or null - Median price in EUR",
"puissance_din": "string or null - DIN power filter applied",
"total_annonces": "integer - Total listings found on the site for the search criteria",
"pages_analysees": "integer - Number of pages fetched",
"annonces_analysees": "integer - Number of listings analyzed after local filters"
},
"sample": {
"data": {
"annee": null,
"boite": null,
"titre": null,
"marque": "RENAULT",
"modele": "CLIO",
"energie": null,
"annonces": [
{
"prix": 5490,
"annee": 2007,
"marque": "RENAULT",
"modele": "CLIO",
"couleur": "gris clair verni",
"energie": "ESSENCE",
"version": "III 1.6 16S 110 INITIALE BVA 5P",
"categorie": "CITADINE",
"reference": "W103444836",
"kilometrage": 120800,
"motorisation": "1.6 111",
"boite_vitesse": "AUTO"
}
],
"prix_max": 11990,
"prix_min": 2490,
"prix_moyen": 6690.43,
"prix_median": 6750,
"puissance_din": null,
"total_annonces": 15869,
"pages_analysees": 1,
"annonces_analysees": 23
},
"status": "success"
}
}About the La Centrale API
What the endpoint returns
The get_price_stats endpoint queries La Centrale listings for a given vehicle configuration and returns aggregate price statistics alongside the individual listings that produced them. The response includes prix_min, prix_max, and prix_moyen (all in EUR), plus the full annonces array. Each listing object in annonces carries prix, marque, modele, annee, energie, boite_vitesse, kilometrage, version, motorisation, and categorie — enough detail to compare individual offers against the aggregate.
Filtering options
The two required parameters are marque (e.g. RENAULT, BMW) and modele (e.g. CLIO, SERIE 3), both in uppercase. Optional filters narrow results further: annee matches an exact model year, energie accepts ESSENCE, DIESEL, ELECTRIQUE, HYBRIDE, or GPL, and boite accepts MANUELLE or AUTOMATIQUE. The titre parameter does a substring match against the version string (e.g. TCE 75 GENERATION), and puissance_din filters by DIN horsepower extracted from the motorization field.
Pagination and coverage
Listings are fetched in pages of 23. The max_pages parameter controls how many pages are retrieved; setting it to 0 fetches all available pages up to a ceiling of 50 pages (roughly 1,150 listings). This matters when you need a statistically representative sample for popular models with many active listings, versus a quick price check where a single page suffices.
The La Centrale API is a managed, monitored endpoint for lacentrale.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lacentrale.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lacentrale.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Estimate fair market value for a specific trim (e.g. CLIO TCE 75 GENERATION, 2020, MANUELLE) before buying or selling
- Build a car valuation tool that returns
prix_minandprix_maxas a price range for a given configuration - Track how diesel vs. petrol pricing differs for the same model by calling with
energieset to DIESEL then ESSENCE - Compare automatic vs. manual transmission price premiums using the
boitefilter across identical make/model/year combinations - Populate a dealer pricing dashboard with live
annoncesarray data includingkilometrageandversionper listing - Analyze how DIN horsepower (
puissance_din) correlates with median price across trims of the same model - Aggregate historical snapshots of
prix_moyenover time to build a used-car price index for French market segments
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does La Centrale have an official developer API?+
What does the `annonces` array contain, and how detailed is each listing?+
annonces includes prix, marque, modele, annee, energie, boite_vitesse, kilometrage, version, motorisation, and categorie. This covers the core fields visible on a listing card — price, year, fuel type, gearbox, mileage, and trim description — but does not include seller contact details, location/department, listing URL, or photos.Does the API cover listing location or regional price differences?+
annonces response fields do not include geographic data such as department, region, or city. Price statistics are computed across all matching national listings. You can fork this API on Parse and revise it to add a location filter or per-region breakdown endpoint.How many listings does a single call process, and does `max_pages` affect the statistics?+
max_pages set to 0, the endpoint fetches up to 50 pages, giving a maximum sample of roughly 1,150 listings per call. prix_min, prix_max, and prix_moyen are computed from all listings retrieved, so a higher max_pages value produces statistics based on a larger sample — which matters for high-volume models.Can the API return price statistics for professional dealer listings separately from private sellers?+
annonces array includes a categorie field per listing, but there is no filter parameter to restrict results to private or professional sellers at query time. Statistics are computed across all matching listings regardless of seller type. You can fork this API on Parse and revise it to add a seller-type filter parameter.