encheres-publiques.com APIencheres-publiques.com ↗
Access French auction data via 5 endpoints: search lots, get lot details, browse events, and list organizers across real estate, vehicles, art, and equipment.
curl -X GET 'https://api.parse.bot/scraper/afe0c866-5c8a-41c0-b83e-1a3301502a9f/search_auction_lots?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for auction lots with optional filters. Returns paginated results sorted by trending. Supports filtering by category, sub-category, location, and whether to include past/sold lots.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return per page. |
| cursor | string | Pagination cursor from a previous response to fetch the next page of results. |
| termine | boolean | Whether to include past/sold lots in results. |
| category | string | Category slug to filter lots. Accepted values: immobilier, vehicules, mobilier-objets-art, materiels. |
| location | string | Location slug to filter by geographic area (e.g. paris-75). |
| sub_category | string | Sub-category slug to narrow results within a category (e.g. appartements, maisons). |
{
"type": "object",
"fields": {
"total": "integer total number of matching lots",
"collection": "array of lot objects with id, nom, photo, categorie, sous_categorie, type, statut, resultat, estimation_basse, estimation_haute, mise_a_prix, prix_adjuge, criteres_resume, evenement, organisateur"
},
"sample": {
"data": {
"total": 636,
"collection": [
{
"id": "127812",
"nom": "Une maison de 216,9 m² située rue Stéphane Mallarmé à Bois-le-Roi",
"url": "",
"type": "En salle",
"photo": null,
"suivi": false,
"statut": "VIDE",
"resultat": "INCONNU",
"categorie": "immobilier",
"evenement": {
"id": "21371",
"type": "En salle",
"titre": "Vente immobilière au Tribunal judiciaire Melun le 7 Mai 2026",
"statut": "VIDE",
"fermeture_date": 1778169600,
"ouverture_date": 1778155200
},
"mise_a_prix": 10000,
"prix_adjuge": null,
"organisateur": {
"id": "5330",
"nom": "Tribunal judiciaire de MELUN",
"avatar": null
},
"sous_categorie": "maisons",
"criteres_resume": "Bois-le-Roi · 216.9 m² · 46 €/m²",
"estimation_basse": null,
"estimation_haute": null
}
]
},
"status": "success"
}
}About the encheres-publiques.com API
The encheres-publiques.com API gives developers structured access to French public auction data across 4 categories through 5 endpoints. Use search_auction_lots to query active or past lots by category, sub-category, and geographic area, or call get_auction_lot_detail to retrieve starting prices, descriptions, address coordinates, and linked event metadata for any individual lot.
Lot Search and Detail
The search_auction_lots endpoint accepts category slugs (immobilier, vehicules, mobilier-objets-art, materiels), a location slug (e.g. paris-75), an optional sub_category (e.g. appartements, maisons), and a termine flag to include past or sold lots. Results are paginated via a cursor field and each lot object in the collection array carries fields including id, nom, photo, categorie, sous_categorie, statut, resultat, estimation_basse, and estimation_haute. The get_auction_lot_detail endpoint takes a numeric lot_id and returns the full lot record: description, mise_a_prix (starting price), an adresse_defaut object with ville, region, departement, and coordinates, plus a nested evenement object linking the lot to its parent auction event.
Auction Events and Organizers
list_auction_events returns upcoming and recent auction events sorted by opening date. Each event object includes titre, statut, type, nbr_total_lots, ouverture_date, fermeture_date, nbr_vues, and an organisateur block. The same category and location filters available on lot search apply here. get_auction_event_detail takes an event_id and returns full event metadata including an adresse object (or null for online events), a mosaique collection of lot previews with a total count, and organizer details.
Organizer Profiles
list_organizer_profiles returns tribunal, notary, and auction house profiles sorted by trending popularity. Each profile includes id, nom, avatar, categorie, online status, and adresse. This endpoint is useful for building directories of active French auction organizers or filtering events by a known organizer ID obtained here.
- Aggregate French real estate auction listings by department, pulling
estimation_basseandestimation_hautefor price range analysis. - Build a vehicle auction tracker filtering
search_auction_lotsby thevehiculescategory and monitoringstatutchanges. - Display a calendar of upcoming art and furniture auction events using
ouverture_dateandfermeture_datefromlist_auction_events. - Map auction lot locations across France by reading
adresse_defaut.coordsfromget_auction_lot_detail. - Create an organizer directory for French tribunals and notaries using profiles from
list_organizer_profiles. - Alert users when new lots are listed in a specific sub-category such as
maisonsin a targetlocationslug. - Analyze sold lot prices by querying past lots with
termine: trueand comparingresultatagainstmise_a_prix.
| 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 encheres-publiques.com provide an official public developer API?+
How do I retrieve only active (unsold) lots for a specific French region?+
search_auction_lots with termine set to false (or omitted), pass a location slug such as lyon-69, and set the category parameter to the relevant slug. The response collection will contain lots whose statut reflects active listings. Use the cursor field from the response to page through further results.What does the `mosaique` field in `get_auction_event_detail` contain?+
mosaique object contains a collection array of lot preview objects belonging to that event and a total count of all lots in the event. It lets you see which lots are associated with an event without calling get_auction_lot_detail individually for each one.Does the API expose bidding history or individual bid amounts for a lot?+
mise_a_prix), price estimates (estimation_basse, estimation_haute), and final result (resultat) for concluded lots, but individual bid-by-bid history is not exposed. You can fork the API on Parse and revise it to add an endpoint targeting that data if it becomes accessible.Is geographic filtering limited to specific location slugs?+
location parameter accepts slugs in the format used by encheres-publiques.com (e.g. paris-75, lyon-69). There is no free-text geocoding or radius-based search built into the API. The API currently covers the location slugs the source site recognizes; broader geo filtering is not supported. You can fork the API on Parse and revise it to add additional location resolution logic.