Encheres Publiques APIencheres-publiques.com ↗
Access French public auction lots, events, and organizer profiles via the enchères-publiques.com API. Filter by category, location, and status across real estate, vehicles, and art.
What is the Encheres Publiques API?
The enchères-publiques.com API gives developers access to French public auction data across 5 endpoints, covering lot listings, event schedules, and organizer profiles. Using search_auction_lots, you can query active and past lots by category, sub-category, and geographic location, retrieving fields like starting price (mise_a_prix), final adjudicated price (prix_adjuge), event details, and organizer identity. The API covers real estate, vehicles, art, and equipment auctions across France.
curl -X GET 'https://api.parse.bot/scraper/afe0c866-5c8a-41c0-b83e-1a3301502a9f/search_auction_lots?limit=5&termine=false&category=immobilier' \ -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 encheres-publiques-com-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.
from parse_apis.encheres_publiques_api import EncheresPubliques, Category
client = EncheresPubliques()
# Search for real estate auction lots (active only)
for lot in client.lotsummaries.search(category=Category.IMMOBILIER, termine=False, limit=5):
print(lot.nom, lot.mise_a_prix, lot.criteres_resume)
# Navigate from summary to full detail
detail = lot.details()
print(detail.description, detail.nbr_vues)
if detail.adresse_defaut:
print(detail.adresse_defaut.ville, detail.adresse_defaut.region)
# List upcoming vehicle auction events
for event in client.eventsummaries.list(category=Category.VEHICULES, limit=3):
print(event.titre, event.nbr_total_lots, event.ouverture_date)
# Get full event details including lot mosaique
full_event = event.details()
print(full_event.organisateur.nom, full_event.organisateur.categorie)
for preview in full_event.mosaique.collection:
print(preview.nom, preview.mise_a_prix)
# List organizer profiles sorted by popularity
for org in client.organizerprofiles.list(limit=5):
print(org.nom, org.categorie, org.online)
if org.adresse:
print(org.adresse.ville, org.adresse.region)
Full-text search over French public auction lots. Returns results sorted by trending popularity. Supports filtering by category, sub-category, location, and whether to include past/sold lots. Each lot includes pricing, status, event info, and organizer. Paginates via the last item's ID as cursor.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return per page. |
| cursor | string | Pagination cursor (last item's id from a previous response) to fetch the next page. |
| termine | boolean | Whether to include past/sold lots in results. |
| category | string | Category slug to filter lots. |
| 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, terrains). |
{
"type": "object",
"fields": {
"total": "integer total number of matching lots",
"collection": "array of lot summary objects"
},
"sample": {
"data": {
"total": 507,
"collection": [
{
"id": "128633",
"nom": "Un terrain à bâtir de 641 m²",
"url": "",
"type": "En salle",
"photo": "/back/services/streetview?adresse_id=201471",
"suivi": false,
"statut": "VIDE",
"resultat": "ADJUGE",
"categorie": "immobilier",
"evenement": {
"id": "21565",
"type": "En salle",
"titre": "Vente immobilière au Tribunal judiciaire de Bobigny",
"statut": "VIDE",
"fermeture_date": 1780416000,
"ouverture_date": 1780401600
},
"mise_a_prix": 6000,
"prix_adjuge": 18000,
"organisateur": {
"id": "5390",
"nom": "Tribunal Judiciaire de BOBIGNY",
"avatar": null
},
"sous_categorie": "terrains",
"criteres_resume": "Rosporden · 641 m²",
"estimation_basse": null,
"estimation_haute": null
}
]
},
"status": "success"
}
}About the Encheres Publiques API
Lot Search and Detail
search_auction_lots accepts free-text queries and supports filtering via category, sub_category (e.g. appartements, maisons, terrains), and location slugs like paris-75. The termine boolean controls whether past or sold lots are included in results. Each item in the collection array carries pricing, status, event metadata, and organizer info. Pagination is cursor-based: pass the id of the last item in the current page as the cursor parameter on the next request. get_auction_lot_detail fetches a single lot by its numeric ID and returns extended fields including description, adresse_defaut (with ville, region, departement, and coordinates), mise_a_prix, and prix_adjuge when the lot has closed.
Events and Organizers
list_auction_events returns upcoming and recent auction events sorted by opening date, with optional category and location filters. Each event in the response collection links to its organizer and provides schedule dates. get_auction_event_detail fetches a single event by its numeric ID, returning the full organisateur object (id, nom, avatar, categorie), an adresse object (or null for online-only events), and a mosaique field that previews the lots belonging to that event with a total count.
Organizer Profiles
list_organizer_profiles returns tribunal, notary, auction house, and bailiff profiles sorted by trending popularity. Each profile object includes id, nom, avatar, categorie, online flag, and adresse. This endpoint accepts only a limit parameter and does not support cursor pagination or filtering by category or location.
The Encheres Publiques API is a managed, monitored endpoint for encheres-publiques.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when encheres-publiques.com 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 encheres-publiques.com 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?+
- Build a property auction tracker filtering
immobilierlots bydepartementand alerting on newmise_a_prixvalues. - Aggregate upcoming auction events by region using
list_auction_eventswithlocationslugs to display a regional calendar. - Monitor
prix_adjugeversusmise_a_prixacross closed lots to analyze French auction price realization rates. - Index vehicle and equipment lot descriptions from
get_auction_lot_detailfor a search tool targeting French public liquidation sales. - Map auction organizers across France using
adresseand coordinate fields fromlist_organizer_profilesand event detail responses. - Display a lot mosaic for a given auction event using the
mosaique.collectionarray returned byget_auction_event_detail. - Filter art and collectible lots by sub-category to build a dedicated French fine art auction feed.
| 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 enchères-publiques.com have an official developer API?+
How do I retrieve only active (not yet closed) lots from `search_auction_lots`?+
termine parameter to false (or omit it if that is the default). When termine is true, the results include past and sold lots alongside active ones. The prix_adjuge field on a lot detail will be null for lots that have not yet closed.Does pagination work the same way across all endpoints?+
search_auction_lots and list_auction_events both use cursor-based pagination: take the id of the last item in the current collection and pass it as the cursor parameter on the next request. list_organizer_profiles does not support cursor pagination — it returns a single page up to the requested limit with no cursor mechanism.Does the API expose individual bidder accounts, bid histories, or real-time bid feeds?+
Can I filter `list_organizer_profiles` by organizer category or region?+
limit parameter. Category and location filtering for organizer profiles are not supported. The categorie field is present on each returned profile object so you can filter client-side. You can fork this API on Parse and revise it to add server-side category or location filtering for organizer queries.