La Centrale APIlacentrale.fr ↗
Search used car listings from La Centrale (lacentrale.fr) via API. Filter by make, model, fuel type, gearbox, price, mileage, and year. Returns up to 16 listings per page.
What is the La Centrale API?
The La Centrale API provides access to used car listings from lacentrale.fr, France's leading automotive marketplace, through a single search_cars endpoint that returns up to 16 vehicle records per page across 14 structured fields per listing. Each result includes make, model, year, price, mileage, fuel type, gearbox, and exterior color, with filters for transmission, energy type, year range, and pagination control via max_pages (capped at 50).
curl -X GET 'https://api.parse.bot/scraper/efdbce48-24af-490b-8937-33266159cb2b/search_cars?make=PEUGEOT&page=1&model=308&energy=ESSENCE&gearbox=MANUAL&year_max=2024&year_min=2015&max_pages=1&price_max=50000&price_min=5000&mileage_max=150000' \ -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-fr-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.
"""La Centrale: search used-car listings by make, energy, price, and more."""
from parse_apis.la_centrale_car_listings_api import LaCentrale, Energy, Gearbox, ListingNotFound
client = LaCentrale()
# Search for diesel Peugeots under 20k euros
for listing in client.listings.search(make="PEUGEOT", energy=Energy.DIESEL, price_max=20000, limit=5):
print(listing.make, listing.model, listing.price, listing.mileage)
# Drill into one Ferrari listing
ferrari = client.listings.search(make="FERRARI", gearbox=Gearbox.AUTO, limit=1).first()
if ferrari:
print(ferrari.reference, ferrari.year, ferrari.detailed_model, ferrari.energy)
# Typed error handling
try:
for item in client.listings.search(make="ZZZZNOTREAL", limit=1):
print(item.reference)
except ListingNotFound as exc:
print(f"No listings found: {exc}")
print("exercised: listings.search with Energy enum, Gearbox enum, and ListingNotFound error")
Full-text search over La Centrale's used-car inventory with filters for make, model, energy type, gearbox, price range, mileage, and year. Returns paginated results (up to 16 listings per page). When no filters are supplied, returns the broadest inventory. Pagination is controlled by page and max_pages; the response includes total count for client-side page math.
| Param | Type | Description |
|---|---|---|
| make | string | Car manufacturer (e.g., FERRARI, BMW, PEUGEOT, RENAULT). Case-insensitive, converted to uppercase internally. |
| page | integer | Starting page number for results. |
| model | string | Car model (e.g., 308, X5, CLIO). Must be used together with make. |
| energy | string | Fuel type filter. |
| gearbox | string | Transmission type filter. |
| year_max | integer | Maximum year of manufacture. |
| year_min | integer | Minimum year of manufacture. |
| max_pages | integer | Maximum number of pages to fetch. Capped at 50. Each page returns up to 16 listings. |
| price_max | integer | Maximum price in euros. |
| price_min | integer | Minimum price in euros. |
| mileage_max | integer | Maximum mileage in kilometers. |
{
"type": "object",
"fields": {
"page": "integer - Starting page number used for this request",
"total": "integer - Total number of matching listings across all pages",
"listings": "array of Listing objects with vehicle details",
"pages_fetched": "integer - Number of pages actually fetched",
"listings_count": "integer - Number of listings returned in this response"
}
}About the La Centrale API
What the API Returns
The search_cars endpoint queries the La Centrale used car inventory and returns paginated listing objects. Each page contains up to 16 results. The top-level response includes total (the full count of matching listings across all pages), pages_fetched, listings_count, and the listings array. Each listing object carries a reference identifier alongside vehicle attributes: make, model, year, price, mileage, energy, gearbox, and exterior_color.
Filtering and Pagination
The make parameter accepts any manufacturer name (e.g., FERRARI, RENAULT, BMW) and is normalized to uppercase. model can be combined with make to narrow results to a specific variant such as CLIO or 308. The energy filter accepts ESSENCE, DIESEL, ELECTRIQUE, or HYBRIDE. Transmission can be filtered using gearbox with values MANUAL or AUTO. Year range is controlled with year_min and year_max. Use page to set the starting page and max_pages to control how many pages are fetched in a single call, up to a cap of 50 pages (800 listings).
Coverage and Scope
Listings are sourced from lacentrale.fr, which focuses on the French used car market. Results reflect the live inventory available on the platform at query time. The total field in the response tells you how many matching vehicles exist across all pages, so you can decide whether to paginate further before committing to a full max_pages pull.
The La Centrale API is a managed, monitored endpoint for lacentrale.fr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lacentrale.fr 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.fr 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?+
- Aggregating French used car prices for a specific make and model to build a market valuation tool
- Monitoring Ferrari or other luxury car inventory levels and price trends on the French market
- Filtering electric (
ELECTRIQUE) and hybrid (HYBRIDE) vehicle listings to support EV-focused comparison features - Extracting mileage and year data across a model range to build depreciation or pricing curves
- Building a lead-generation pipeline for used car dealers by tracking new listings matching specific filters
- Comparing automatic vs manual transmission availability and pricing for a given model across years
- Populating a car-search app with live French market inventory filtered by fuel type and price range
| 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 offer an official developer API?+
What does the search_cars endpoint return beyond basic price and mileage?+
reference, make, model, year, price, mileage, energy (fuel type), gearbox (transmission), and exterior_color. The total field in the response shows the full count of matching listings across all pages, and pages_fetched confirms how many pages were actually retrieved in the call.Does the API support filtering by price range?+
search_cars endpoint does not expose price_min or price_max filter parameters. Filtering is limited to make, model, energy, gearbox, year_min, and year_max. You can fork this API on Parse and revise it to add price-range filtering if that capability is needed.Is seller contact information or individual listing detail pages included?+
How does pagination work and what is the maximum number of listings retrievable per request?+
max_pages parameter controls how many pages are fetched in a single API call, with a hard cap of 50 pages — meaning a maximum of 800 listings per request. Use the page parameter to set the starting page offset, and use the total field in the response to determine whether further calls are needed to exhaust results.