# France Judicial Real-Estate Auctions Scraper (`signalflow/france-judicial-auctions`) Actor Scrape Licitor (licitor.com) — French judicial real-estate auctions (ventes aux enchères): mise à prix, court, sale date, address, surface and the cahier des conditions PDF, plus legal price-drop levels and estimated frais préalables. Filter by region, type and price. Export to JSON/CSV/Excel. - **URL**: https://apify.com/signalflow/france-judicial-auctions.md - **Developed by:** [SignalFlow](https://apify.com/signalflow) (community) - **Categories:** Real estate, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🇫🇷 France Judicial Real-Estate Auctions Scraper Extract upcoming French judicial real-estate auctions from [Licitor](https://www.licitor.com) — the reference platform for *ventes aux enchères immobilières* since 1996. Get structured data on properties, starting prices, tribunal details, sale dates, PDF legal documents, and smart calculated fields like legal price-drop levels, estimated auction fees, and price-per-m². --- ### 🎯 Why use this Scraper? Judicial auctions in France move fast and the data is fragmented across dozens of tribunal pages. This Actor solves that by: * **Bulk extraction** of every upcoming auction in a region — or all of France. * **Structured output** (JSON / Excel / CSV) instead of manually browsing tribunal-by-tribunal. * **Smart, legally-grounded fields** — legal price-drop levels (½, ⅔ of the *mise à prix*), an estimate of the mandatory *frais préalables* (~12%) the buyer pays on top, the estimated total cash needed, and price-per-m². * **Legal documents** — optional PDF download of the *cahier des conditions de vente*. * **Google Maps links** on every property so you can inspect locations instantly. --- ### 🏢 Use Cases * **Real-estate investors** — spot undervalued properties before the auction date. * **Notaires & avocats** — monitor tribunal calendars and competing listings. * **Market research** — analyse starting prices, surface areas, and price-per-m² by region. * **Data enrichment** — append auction data to an existing property or CRM dataset. --- ### 📦 Output Data Each result is a structured record with the following fields: `id`, `title`, `type`, `price_base`, `price_base_fmt`, `minimum_bid`, `court`, `procedure_number`, `sale_date`, `sale_type`, `address`, `city`, `department`, `region`, `surface_m2`, `description`, `agent`, `detail_url`, `pdf_url`, `photos`, `google_maps_url`, `status`, `baisse_mise_a_prix_50_fmt`, `baisse_mise_a_prix_66_fmt`, `frais_prealables_estimate_fmt`, `cout_total_estimatif_fmt`, `price_per_m2`. #### Example output > ℹ️ The values below are **illustrative samples**, not a real listing. ```json { "id": "108325", "title": "Un studio", "type": "Studio", "price_base": 55200.0, "price_base_fmt": "55 200,00 €", "minimum_bid": "Consignation : 5 520 €", "court": "Tribunal Judiciaire de Paris", "procedure_number": "25/00214", "sale_date": "2026-06-04T14:00:00", "sale_type": "Vente aux enchères publiques en un lot", "address": "1-3-5, passage Ruelle, Paris 18ème", "city": "Paris 18ème", "department": "75", "region": "Île-de-France", "surface_m2": 23.0, "description": "de 23 m², au 1er étage, escalier A et B face à l'escalier C, comprenant : pièce principale, kitchenette, salle de bains, wc Occupé", "agent": "Maître Jean EXEMPLE, Avocat", "detail_url": "https://www.licitor.com/annonce/10/83/25/vente-aux-encheres/un-studio/paris-18eme/paris/108325.html", "pdf_url": "https://www.licitor.com/data/pub/media/annonce/10/83/25/108325.000.001.c76b94cb4c43.pdf", "photos": [], "google_maps_url": "https://maps.google.fr/maps?q=48.8865242,2.3588109&z=13", "status": "active", "baisse_mise_a_prix_50_fmt": "27 600,00 €", "baisse_mise_a_prix_66_fmt": "36 432,00 €", "frais_prealables_estimate_fmt": "6 624,00 €", "cout_total_estimatif_fmt": "61 824,00 €", "price_per_m2": 2400.0 } ```` > **About the calculated fields (French judicial-auction law):** the *mise à prix* (starting price) > is set by the judge — often based on the debtor's remaining debt, **not** market value — so a > generic "investor bid limit" off the starting price is meaningless. Instead we provide legally > meaningful figures: > > - **`baisse_mise_a_prix_50_fmt` / `baisse_mise_a_prix_66_fmt`** — if nobody bids (*carence > d'enchères*), the judge may apply a *faculté de baisse de mise à prix*; the standard legal drops > are to **½** or **⅔** of the starting price. These tell you the next possible starting prices. > - **`frais_prealables_estimate_fmt`** — estimated mandatory auction costs (~12%) the buyer pays **on > top of** the winning bid. > - **`cout_total_estimatif_fmt`** — starting price + estimated frais préalables = the cash an investor > actually budgets against. *** ### ⚙️ Input | Field | Type | Default | Description | |---|---|---|---| | `region` | `string` | `"france"` | Region to search: `france`, `paris-et-ile-de-france`, `bretagne-grand-ouest`, `centre-loire-limousin`, `regions-du-nord-est`, `sud-est-mediterrannee`, `sud-ouest-pyrenees`. | | `tribunal` | `string` | `""` | Optional tribunal filter (partial match), e.g. `paris`, `lyon`. | | `min_price` | `integer` | `0` | Minimum starting price (mise à prix) in €. 0 = no limit. | | `max_price` | `integer` | `0` | Maximum starting price in €. 0 = no limit. | | `max_items` | `integer` | `100` | Maximum auctions to return. `0` = unlimited. | | `download_pdf` | `boolean` | `true` | Save the *cahier des conditions de vente* PDF to permanent storage (so it's never lost if the source link expires). Set `false` to keep only source links. | | `include_unpriced` | `boolean` | `false` | Include auctions with no starting price set yet. Off by default to avoid empty/N/A rows. | *** ### 💡 Tips - **Start small** — run with `max_items: 5` to verify the output format before a full scrape. - **Filter by tribunal** — useful when a region covers many courts (e.g. Île-de-France has 10+ tribunals). - **Price filters** — combine `min_price` and `max_price` to focus on your investment bracket. - **PDF documents are saved by default** to permanent storage, so the cahier des conditions is never lost if the source link expires. Set `download_pdf: false` to keep only the source links for slightly faster runs. - **Full France export** — set `region: france` and `max_items: 0` for a complete national snapshot. *** ### 🤖 Use it as an AI Tool (MCP) This Actor is **Model Context Protocol (MCP) compatible**, so AI assistants like Claude can call it directly through the [Apify MCP Server](https://mcp.apify.com/). The input is described so an assistant can fill it in from a natural-language request, for example: > *"Find 20 upcoming judicial auctions in Paris with a starting price under 200,000 € and return their addresses, sale dates, and PDF links."* The assistant maps that to `region: "paris-et-ile-de-france"`, `max_price: 200000`, `max_items: 20` and reads the structured results — no manual configuration needed. *** ### 📜 Disclaimer This Actor extracts **publicly available judicial auction notices** from Licitor. The data is published for public information purposes. You are responsible for using the data in compliance with applicable laws. Do not use the data for unlawful purposes. Always verify auction details directly with the relevant tribunal before bidding. *** ### 🇫🇷 Pour les investisseurs et professionnels français Cet Actor extrait automatiquement les **ventes aux enchères immobilières judiciaires** publiées sur [Licitor](https://www.licitor.com), la référence des *ventes aux enchères* depuis 1996. Idéal pour les investisseurs immobiliers, marchands de biens, notaires et avocats. #### 🚀 Pourquoi l'utiliser ? - **Extraction en masse** de toutes les ventes à venir d'une région — ou de toute la France. - **Données structurées** (JSON / Excel / CSV) au lieu de parcourir les tribunaux un par un. - **Documents officiels** : téléchargement du *cahier des conditions de vente* (PDF). #### 💰 Champs intelligents (conformes au droit français) La *mise à prix* est fixée par le juge — souvent selon la dette du débiteur, **pas** la valeur de marché. Nous fournissons donc des indicateurs juridiquement pertinents : - **`baisse_mise_a_prix_50_fmt` / `baisse_mise_a_prix_66_fmt`** — en cas de *carence d'enchères*, le juge peut appliquer une *faculté de baisse de mise à prix* (½ ou ⅔ du prix de départ). - **`frais_prealables_estimate_fmt`** — estimation des frais préalables (~12 %) payés **en plus** de l'enchère gagnante. - **`cout_total_estimatif_fmt`** — mise à prix + frais estimés = la trésorerie réellement nécessaire. #### 🎯 Cas d'usage - **Investisseurs** : repérer des biens sous-évalués avant la date de vente. - **Notaires & avocats** : suivre les calendriers des tribunaux et la concurrence. - **Étude de marché** : analyser les mises à prix, surfaces et prix au m² par région. *** *Prix et données fournis à titre indicatif — les informations officielles priment toujours.* # Actor input Schema ## `region` (type: `string`): French region to search. Use the Licitor zone slug or a common name, e.g. 'ile-de-france', 'bretagne', 'sud-est', 'france'. ## `tribunal` (type: `string`): Optional tribunal filter. Partial name match, e.g. 'paris', 'lyon', 'marseille'. ## `min_price` (type: `integer`): Only return auctions with a starting price (mise à prix) above this amount. ## `max_price` (type: `integer`): Only return auctions with a starting price below this amount. 0 = no limit. ## `max_items` (type: `integer`): Maximum number of auctions to scrape. 0 = unlimited. ## `download_pdf` (type: `boolean`): Save each 'cahier des conditions de vente' PDF to permanent storage and return a stable URL, so the document is never lost even if the source link expires. On by default; turn off to only keep the original source links (slightly faster). ## `proxyConfiguration` (type: `object`): Proxy settings. Recommended on — the site limits requests per IP and the Actor rotates IPs automatically. Defaults to the Apify Proxy (datacenter); switch to RESIDENTIAL if you still see rate-limits. ## `include_unpriced` (type: `boolean`): Include listings with no price set yet. Off by default to avoid empty/N/A rows. ## Actor input object example ```json { "region": "paris-et-ile-de-france", "tribunal": "", "min_price": 0, "max_price": 0, "max_items": 100, "download_pdf": true, "proxyConfiguration": { "useApifyProxy": true }, "include_unpriced": false } ``` # Actor output Schema ## `dataset` (type: `string`): All scraped items in a table you can view, filter and export (JSON, CSV, Excel, XML). ## `documents` (type: `string`): Auction PDF documents saved to the key-value store (permanent links). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "region": "paris-et-ile-de-france" }; // Run the Actor and wait for it to finish const run = await client.actor("signalflow/france-judicial-auctions").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "region": "paris-et-ile-de-france" } # Run the Actor and wait for it to finish run = client.actor("signalflow/france-judicial-auctions").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "region": "paris-et-ile-de-france" }' | apify call signalflow/france-judicial-auctions --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=signalflow/france-judicial-auctions", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "France Judicial Real-Estate Auctions Scraper", "description": "Scrape Licitor (licitor.com) — French judicial real-estate auctions (ventes aux enchères): mise à prix, court, sale date, address, surface and the cahier des conditions PDF, plus legal price-drop levels and estimated frais préalables. Filter by region, type and price. Export to JSON/CSV/Excel.", "version": "0.1", "x-build-id": "tKGG0n5yckRcaWaYW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalflow~france-judicial-auctions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalflow-france-judicial-auctions", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/signalflow~france-judicial-auctions/runs": { "post": { "operationId": "runs-sync-signalflow-france-judicial-auctions", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/signalflow~france-judicial-auctions/run-sync": { "post": { "operationId": "run-sync-signalflow-france-judicial-auctions", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "region": { "title": "Region", "enum": [ "france", "paris-et-ile-de-france", "ile-de-france", "bretagne-grand-ouest", "bretagne", "centre-loire-limousin", "centre", "regions-du-nord-est", "nord-est", "sud-est-mediterrannee", "sud-est", "sud-ouest-pyrenees", "sud-ouest" ], "type": "string", "description": "French region to search. Use the Licitor zone slug or a common name, e.g. 'ile-de-france', 'bretagne', 'sud-est', 'france'.", "default": "france" }, "tribunal": { "title": "Tribunal", "type": "string", "description": "Optional tribunal filter. Partial name match, e.g. 'paris', 'lyon', 'marseille'.", "default": "" }, "min_price": { "title": "Minimum Starting Price (€)", "minimum": 0, "type": "integer", "description": "Only return auctions with a starting price (mise à prix) above this amount.", "default": 0 }, "max_price": { "title": "Maximum Starting Price (€)", "minimum": 0, "type": "integer", "description": "Only return auctions with a starting price below this amount. 0 = no limit.", "default": 0 }, "max_items": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of auctions to scrape. 0 = unlimited.", "default": 100 }, "download_pdf": { "title": "Download PDF documents", "type": "boolean", "description": "Save each 'cahier des conditions de vente' PDF to permanent storage and return a stable URL, so the document is never lost even if the source link expires. On by default; turn off to only keep the original source links (slightly faster).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Recommended on — the site limits requests per IP and the Actor rotates IPs automatically. Defaults to the Apify Proxy (datacenter); switch to RESIDENTIAL if you still see rate-limits.", "default": { "useApifyProxy": true } }, "include_unpriced": { "title": "Include unscheduled/unpriced listings", "type": "boolean", "description": "Include listings with no price set yet. Off by default to avoid empty/N/A rows.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```