lacentrale.com 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.
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'
Get price statistics for a given car configuration from La Centrale listings. Fetches listing pages and computes min, max, average, and median prices. Supports filtering by make, model, year, fuel type, gearbox, version title, and DIN horsepower.
| 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). |
| 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). |
{
"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": "2020",
"boite": null,
"titre": null,
"marque": "RENAULT",
"modele": "CLIO",
"energie": null,
"annonces": [
{
"prix": 10990,
"annee": 2020,
"marque": "RENAULT",
"modele": "CLIO",
"couleur": "rouge metal",
"energie": "DIESEL",
"version": "IV (2) 1.5 DCI 90 LIMITED",
"categorie": "CITADINE",
"reference": "W103456864",
"kilometrage": 72000,
"motorisation": "1.5 DCI 90",
"boite_vitesse": "MANUAL"
}
],
"prix_max": 14690,
"prix_min": 7990,
"prix_moyen": 10859.39,
"prix_median": 10799,
"puissance_din": null,
"total_annonces": 1072,
"pages_analysees": 1,
"annonces_analysees": 23
},
"status": "success"
}
}About the lacentrale.com 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.
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.
- 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 | 250 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.