# LaCentrale: Search vehicle listings

`lacentrale/listings/search` · version 2.0.0 · pilot · 23 credits a call

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.

Categories: Cars

## When to use

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.

## Call

```bash
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"}}'
```

The answer's `next` is the whole call for the following page: send it as it is. `null` on the last page.

Beside `options`, the call takes:

| Parameter | Type | Description |
|---|---|---|
| `fields` | array of string | The record fields to keep, by path (`title`, `address.city`); `object`, `id` and `position` always come. Left out: every field. |
| `limit` | integer | Only the first N records of this call (1 to 1000), in the call's order; the call costs the same, and `next` keeps the limit. Left out: every record. |

## Options

| Option | Type | Required | Default | Description |
|---|---|---|---|---|
| `url` | string (uri) | yes |  | A https://www.lacentrale.fr/listing search URL. Defaults: page 1, cars and utility vehicles (vertical=carTruck), the site’s relevance order, no other filters. Use makesModelsCommercialNames=RENAULT:CLIO (semicolon-separated choices), energies=dies,ess,elec,hyb,plug_hyb,not_plug_hyb,gpl,eth,alt; priceMin/Max in euros, yearMin/Max in calendar years and mileageMin/Max in kilometres. Sort with sortBy=firstOnlineDateDesc (newest), priceAsc/Desc, mileageAsc/Desc, firstTrafficDateAsc/Desc or proximityAsc/Desc. Supports the site’s other typed /listing filters; unknown parameters are refused. Page is one-based and limited to 347: at most 7,981 results. Narrow filters to retrieve more. Ranking uses the French proxy’s location unless continuing with next; it may differ from a personal browser with another location or seed. |
| `cursor` | string |  |  | Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor). It keeps the ranking of the first page (its seed and location) across pages. Leave it out to start at the URL's page. |

## Record

Each item of `results`. Every field is always present, `null` when the site gives nothing.

| Field | Type | Description |
|---|---|---|
| `object` | `"listing"` |  |
| `id` | string | LaCentrale reference, such as W103592947. |
| `position` | integer | One-based position across pages: 24 is the first result of page 2. |
| `url` | string (uri) | Public listing URL on lacentrale.fr. |
| `title` | string | null | Card title: manufacturer and commercial model name. |
| `price` | object | null | An amount in euros. |
| `price.amount` | number | Amount in euros. |
| `price.currency` | `"EUR"` |  |
| `ranking_score` | number | null | Native ranking score, dependent on the search context; not a vehicle quality rating. |
| `vehicle` | object | Vehicle specifications supplied by the search. |
| `vehicle.make` | string | null | Manufacturer, in the site’s spelling: RENAULT, BMW. |
| `vehicle.model` | string | null | Model family: CLIO, X1. |
| `vehicle.commercial_name` | string | null | Commercial model name, including its generation where supplied: CLIO 5, X1 F48. |
| `vehicle.detailed_model` | string | null | Detailed model designation: BMW X1 F48 phase 2. |
| `vehicle.version` | string | null | Full version shown below the title, including engine and trim. |
| `vehicle.trim` | string | null | Trim level: XLINE, INTENS. |
| `vehicle.motorization` | string | null | Engine designation, as supplied; may combine displacement and power or electric power and battery capacity. |
| `vehicle.category` | string | null | Native category code: CITADINE, COMPACTE, SUV_4X4_CROSSOVER, SPORTIVE, etc. |
| `vehicle.family` | string | null | Native vehicle family: AUTO, UTILITY, MOTO, QUAD, SCOOTER. |
| `vehicle.energy` | string | null | Native fuel code: DIESEL, ESSENCE, ELECTRIC, HYBRID, PLUGIN_HYBRID, NOT_PLUGIN_HYBRID, etc. |
| `vehicle.gearbox` | string | null | MANUAL or AUTO, when supplied. |
| `vehicle.year` | integer | null | Vehicle year shown on the search card. |
| `vehicle.mileage_km` | integer | null | Odometer reading, in kilometres; zero is retained. |
| `vehicle.doors` | integer | null | Number of doors; the site supplies zero for some motorcycles. |
| `vehicle.exterior_color` | string | null | Exterior colour as written by the seller; may be a commercial colour name. |
| `is_new_listing` | boolean | null | The Nouveauté badge: recently listed, distinct from a new vehicle. |
| `is_new_vehicle` | boolean | null | The site’s neuf flag: the vehicle is advertised as new, distinct from a recently posted listing. |
| `deal_rating` | string | null | Native price assessment: VERY_GOOD_DEAL, GOOD_DEAL, EQUITABLE_DEAL, BAD_DEAL; null when absent. |
| `has_vehicle_history` | boolean | null | An Autoviza vehicle history report is available. |
| `published_date` | string | null (date) | First online date. The search supplies a date only, not a time. |
| `updated_at` | string | null (date-time) | The listing’s last update, converted from Unix seconds to UTC. |
| `recent_price_drop_until` | string | null (date-time) | Expiry of the recent price-drop badge, not the date of a price change; priceDropLimitDate. |
| `location` | object |  |
| `location.country` | string | null | Country code, usually FR. |
| `location.department` | string | null | Department code, not a postal code: 59, 2A. |
| `location.distance_km` | number | null | Distance from the search location when the service supplies _distanceKm. |
| `seller` | object |  |
| `seller.id` | string | null | Public seller reference. |
| `seller.type` | string | null | pro or private; null for an unknown source type. |
| `seller.kind` | string | null | Native seller category: CONCESSIONNAIRE, CENTRE_MULTIMARQUES, PART, DISTANCE, etc. |
| `seller.name` | string | null | Published seller name; null when none is given. |
| `seller.phones` | array | Public phone numbers present in the search payload, in order, without duplicates. |
| `seller.phones[].number` | string | null | Phone in international format when recognisable. |
| `seller.phones[].as_written` | string | Public phone as supplied, decoded from displayPhone1/2. |
| `photos` | object |  |
| `photos.urls` | array of string | Main photo and mobile image URLs, in source order, without exact duplicates; includes size variants, not necessarily every listing photo. |
| `photos.count` | integer | null | Total photo count reported by the site; may exceed the supplied URLs. |
| `photos.updated_at` | string | null (date-time) | Timestamp attached to the site’s photo count (picturesCountDate). |
| `photos.has_exterior_360` | boolean | null | An exterior 360-degree view is available. |
| `photos.has_photosphere` | boolean | null | A photosphere is available. |
| `warranty` | object |  |
| `warranty.months` | integer | null | Warranty duration in months (manufacturerWarrantyDuration). Detail pages label it Garantie: verified 2 and 12 months; not necessarily a manufacturer warranty. |
| `warranty.manufacturer_until` | string | null (date) | End date of the manufacturer warranty (constructorWarrantyDate). |
| `warranty.has_extension` | boolean | null | The site’s extendedWarranty flag. |
| `financing` | object | null | Advertised monthly loan and lease (LOA) amounts; not a total cost or a binding finance quote. |
| `financing.id` | string | null | Financing offer identifier. |
| `financing.valid_until` | string | null (date-time) | Validity limit supplied as limitDateV2. |
| `financing.loan_monthly_price` | object | null | An amount in euros. |
| `financing.loan_monthly_price.amount` | number | Amount in euros. |
| `financing.loan_monthly_price.currency` | `"EUR"` |  |
| `financing.lease_monthly_price` | object | null | An amount in euros. |
| `financing.lease_monthly_price.amount` | number | Amount in euros. |
| `financing.lease_monthly_price.currency` | `"EUR"` |  |
| `delivery` | object | null | Delivery information when supplied. |
| `delivery.available` | boolean | null | Delivery is active on this listing. |
| `delivery.max_distance_km` | number | null | Maximum delivery distance, in kilometres. |
| `delivery.prices` | array | Delivery price bands in source order. The search does not label their distance brackets. |
| `delivery.prices[].amount` | number | Amount in euros. |
| `delivery.prices[].currency` | `"EUR"` |  |
| `publication_options` | array of string | Publication options attached to the listing, such as DELIVERY, PHOTO_360 and STRENGTHS; an option is not proof a feature is filled. |
| `ids` | object |  |
| `ids.listing_id` | string | Same reference as id. |
| `ids.url_id` | string | Numeric identifier in the public listing URL. |
| `ids.customer_reference` | string | null | Public seller reference. |
| `ids.owner_correlation_id` | string | null | Owner reference supplied by the site. |
| `source_url` | string (uri) | Canonical listing search URL for this page. |
| `observed_at` | string (date-time) | Time the response was read, in UTC. |

Example:

```json
{
  "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"
}
```

## Price

23 credits per call, including a short last page. Empty answers and failed calls are free.

## Errors

| Code | Status | Retry | Message |
|---|---|---|---|
| `invalid_url` | 422 | no | This is not a supported LaCentrale listing URL, or a filter or page is invalid. |
| `invalid_search` | 422 | no | Pass the continuation context unchanged from next, or omit search to start a new search. |
| `site_challenge` | 503 | yes | LaCentrale’s anti-bot refused the request; retry in a minute (not charged). |
| `site_unavailable` | 503 | yes | LaCentrale is unavailable; retry later (not charged). |
| `unexpected_answer` | 424 | no | LaCentrale answered in a shape we do not read yet; we are told and fix it (not charged). |
| `missing_api_key` | 401 | no | No API key: send it as `Authorization: Bearer <key>`. |
| `invalid_api_key` | 401 | no | The key is not valid, or not anymore. |
| `insufficient_credits` | 402 | no | The call costs more credits than are left. |
| `unknown_operation` | 404 | no | No such source and operation in the catalog. |
| `timeout` | 408 | yes | The call did not finish within its deadline (not charged). |
| `invalid_body` | 422 | no | The body is not a call: source, operation, options. |
| `invalid_options` | 422 | no | An option is missing or out of its contract; `param` names it. |
| `invalid_idempotency_key` | 400 | no | The Idempotency-Key header is not printable ASCII, or too long. |
| `concurrency_limit` | 429 | yes | The plan's calls at a time are all in progress (Free 1, Starter 2, Pro 10, Team 50); retry when one has finished (not charged, never queued). |
| `service_busy` | 503 | yes | Too many calls at once on the account; retry in a few seconds. |
| `balance_unavailable` | 503 | yes | The balance could not be read; retry in a few seconds. |

## Changelog

- **2.0.0** (2026-11-13): `next` 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.0** (2026-11-13): First version: 23 standard results per page from LaCentrale’s search API, with vehicle specifications, public seller phones, photo URLs, financing, delivery and warranty data. Continuations retain ranking context. Up to 347 pages per search; 23 credits per nonempty call.

Schema: https://api.lobstr.io/v2/catalog/lacentrale/listings/search · All operations: https://api.lobstr.io/v2/catalog.md
