Skip to content
LaCentrale

Search vehicle listings

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.

lacentrale/listings/search23 credits a callv2.0.0

When to use it

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.

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.

1Request
A https://www.lacentrale.fr/listing search URL.
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).
23 credits a call
Code, from the fields above
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"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_rpkhebjlqkd4gq4p2ngezxejdi",
  "livemode": true,
  "source": "lacentrale",
  "operation": "listings/search",
  "version": "2.0.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/lacentrale/listings/search",
  "options": {
    "url": "https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "lacentrale",
    "operation": "listings/search",
    "options": {
      "url": "https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc",
      "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5"
    }
  },
  "cost": {
    "credits": 23
  },
  "results": [
    {
      "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"
    }
  ]
}

Options

urlstringrequired
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.
cursorstring
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 record of results, in the envelope every call returns (Run an operation).

objectstring
idstring
LaCentrale reference, such as W103592947.
positioninteger
One-based position across pages: 24 is the first result of page 2.
urlstring
Public listing URL on lacentrale.fr.
titlestring
Card title: manufacturer and commercial model name.
price.amountfloat
Amount in euros.
price.currencystring
ranking_scorefloat
Native ranking score, dependent on the search context; not a vehicle quality rating.
vehicle.makestring
Manufacturer, in the site’s spelling: RENAULT, BMW.
vehicle.modelstring
Model family: CLIO, X1.
vehicle.commercial_namestring
Commercial model name, including its generation where supplied: CLIO 5, X1 F48.
vehicle.detailed_modelstring
Detailed model designation: BMW X1 F48 phase 2.
vehicle.versionstring
Full version shown below the title, including engine and trim.
vehicle.trimstring
Trim level: XLINE, INTENS.
vehicle.motorizationstring
Engine designation, as supplied; may combine displacement and power or electric power and battery capacity.
vehicle.categorystring
Native category code: CITADINE, COMPACTE, SUV_4X4_CROSSOVER, SPORTIVE, etc.
vehicle.familystring
Native vehicle family: AUTO, UTILITY, MOTO, QUAD, SCOOTER.
vehicle.energystring
Native fuel code: DIESEL, ESSENCE, ELECTRIC, HYBRID, PLUGIN_HYBRID, NOT_PLUGIN_HYBRID, etc.
vehicle.gearboxstring
MANUAL or AUTO, when supplied.
vehicle.yearinteger
Vehicle year shown on the search card.
vehicle.mileage_kminteger
Odometer reading, in kilometres; zero is retained.
vehicle.doorsinteger
Number of doors; the site supplies zero for some motorcycles.
vehicle.exterior_colorstring
Exterior colour as written by the seller; may be a commercial colour name.
is_new_listingboolean
The Nouveauté badge: recently listed, distinct from a new vehicle.
is_new_vehicleboolean
The site’s neuf flag: the vehicle is advertised as new, distinct from a recently posted listing.
deal_ratingstring
Native price assessment: VERY_GOOD_DEAL, GOOD_DEAL, EQUITABLE_DEAL, BAD_DEAL; null when absent.
has_vehicle_historyboolean
An Autoviza vehicle history report is available.
published_datestring
First online date. The search supplies a date only, not a time.
updated_atdate
The listing’s last update, converted from Unix seconds to UTC.
recent_price_drop_untildate
Expiry of the recent price-drop badge, not the date of a price change; priceDropLimitDate.
location.countrystring
Country code, usually FR.
location.departmentstring
Department code, not a postal code: 59, 2A.
location.distance_kmfloat
Distance from the search location when the service supplies _distanceKm.
seller.idstring
Public seller reference.
seller.typestring
pro or private; null for an unknown source type.
seller.kindstring
Native seller category: CONCESSIONNAIRE, CENTRE_MULTIMARQUES, PART, DISTANCE, etc.
seller.namestring
Published seller name; null when none is given.
seller.phoneslist
Public phone numbers present in the search payload, in order, without duplicates.
photos.urlslist
Main photo and mobile image URLs, in source order, without exact duplicates; includes size variants, not necessarily every listing photo.
photos.countinteger
Total photo count reported by the site; may exceed the supplied URLs.
photos.updated_atdate
Timestamp attached to the site’s photo count (picturesCountDate).
photos.has_exterior_360boolean
An exterior 360-degree view is available.
photos.has_photosphereboolean
A photosphere is available.
warranty.monthsinteger
Warranty duration in months (manufacturerWarrantyDuration). Detail pages label it Garantie: verified 2 and 12 months; not necessarily a manufacturer warranty.
warranty.manufacturer_untilstring
End date of the manufacturer warranty (constructorWarrantyDate).
warranty.has_extensionboolean
The site’s extendedWarranty flag.
financing.idstring
Financing offer identifier.
financing.valid_untildate
Validity limit supplied as limitDateV2.
financing.loan_monthly_price.amountfloat
Amount in euros.
financing.loan_monthly_price.currencystring
financing.lease_monthly_price.amountfloat
Amount in euros.
financing.lease_monthly_price.currencystring
delivery.availableboolean
Delivery is active on this listing.
delivery.max_distance_kmfloat
Maximum delivery distance, in kilometres.
delivery.priceslist
Delivery price bands in source order. The search does not label their distance brackets.
publication_optionslist
Publication options attached to the listing, such as DELIVERY, PHOTO_360 and STRENGTHS; an option is not proof a feature is filled.
ids.listing_idstring
Same reference as id.
ids.url_idstring
Numeric identifier in the public listing URL.
ids.customer_referencestring
Public seller reference.
ids.owner_correlation_idstring
Owner reference supplied by the site.
source_urlstring
Canonical listing search URL for this page.
observed_atdate
Time the response was read, in UTC.

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_url422This is not a supported LaCentrale listing URL, or a filter or page is invalid.
invalid_search422Pass the continuation context unchanged from next, or omit search to start a new search.
site_challenge503LaCentrale’s anti-bot refused the request; retry in a minute (not charged). Retryable.
site_unavailable503LaCentrale is unavailable; retry later (not charged). Retryable.
unexpected_answer424LaCentrale answered in a shape we do not read yet; we are told and fix it (not charged).

Price

23 credits per call, including a short last page. Empty answers and failed calls are free. What a credit costs on each plan: Credits and pricing.

Changelog

2.0.02026-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.02026-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.