# French Accountants Scraper · Expert-Comptable Directory (`corent1robert/experts-comptables-annuaire-scraper`) Actor

Export French accounting firms from the official Ordre register: name, address, phone, website, profile URL. Run by city or nationwide. No login. No API key. Public official register. JSON, CSV, Excel for CRM and B2B prospecting.

- **URL**: https://apify.com/corent1robert/experts-comptables-annuaire-scraper.md
- **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## French Accountants Directory Scraper — experts-comptables.org (HTTP)

**Export the official French expert-comptable register — firm names, addresses, phones, and profile links — in one dataset you can plug into CRM, outbound, or market research.**

Stop copying [annuaire.experts-comptables.org](https://annuaire.experts-comptables.org/) by hand. This Actor reads the **public Ordre directory** over plain HTTP, structures every accounting firm as a row, and lets you run **nationwide**, **by commune**, or **from profile URLs you already have**. Download **JSON**, **CSV**, or **Excel** from the Apify **Dataset** tab — or call the run via **API** and wire it to **Schedules** for monthly refreshes.

**No login. No API key. Public official register.**

> **Important:** Data comes from **public** firm profile pages. Some optional fields (website, languages, competences) appear **only when the site displays them**. Email is **not** included — the register does not expose it in structured data. You must comply with **Ordre des experts-comptables** terms, **GDPR**, and **professional-directory** rules.

---

### Who is this for?

| You are… | Typical goal | Suggested setup |
|----------|--------------|-----------------|
| **B2B supplier / SaaS** selling to accounting firms | Verified firm contacts by region | **By city** with target communes, or **Full directory** for France-wide coverage |
| **Outbound / SDR team** | Phone + address for cold calling or mail | **By city** for a département rollout; export CSV from Dataset |
| **Market researcher / analyst** | Count and map firms nationally | **Full directory** with **Max firms = 0** (no row cap) |
| **Ops / data team** refreshing an old list | Same fields, latest phones | **Your URLs** — paste profile links from a previous export |
| **Franchise / network ops** | Firms in specific communes | **By city** — slug from `/recherche/ville/{slug}` (e.g. `paris`, `rodez`) |

**What you get by default:** firm name, full address, phone, GPS coordinates, and canonical profile URL — typically **~100% fill** on those core fields in our samples. Website and social links are included when the profile publishes them (~10–20% for website on mixed communes).

**Which mode to pick:** use **By city** for your first run (fast, cheap, easy to validate). Switch to **Full directory** when you need a national file (~22k–31k unique firms after deduplication, ~30–45 min on Apify). Use **Your URLs** only when you already have profile links and want a contact refresh without re-scanning communes.

---

### Getting started

#### First run in the Apify Console (~2 minutes)

1. Open this Actor on Apify and go to the **Input** tab.
2. Under **Step 1 — What do you need?**, leave the default **By city** (safest for **Try for free**).
3. Under **Step 2 — Commune slugs**, the default is `rodez` — or replace with your target (e.g. `paris`, `lyon`, `marseille`).
4. Under **Step 3 — Limits**, **Max firms** defaults to **50** on Try — enough to preview the dataset without a long run.
5. Click **Start** (or **Try for free**).
6. While the run executes, watch the log line **`Progress:`** and the short status at the top of the run page (e.g. `Scanning France — 34% · 120 firms saved`).
7. When the run finishes, open the **Output** tab → **Dataset** → preview rows or click **Export** (JSON, CSV, Excel). Use **Quick view (table)** for a curated column set.

#### Export all of France

1. **Step 1** → select **Full directory — nationwide firm export**.
2. **Max firms** → set **0** (no row ceiling).
3. Leave **Max communes** at **0** (all ~4 600 communes) unless you want a smoke test (e.g. set **5** communes via API — see below).
4. **Start** — expect **~22k–31k rows** and **~30–45 minutes** depending on platform load. Rows appear in the Dataset **while the run is still going** (progressive export).

#### Refresh firms you already know

1. **Step 1** → **Your URLs — profile links to refresh**.
2. Paste one official profile URL per line under **Profile URL(s)**.
3. **Start** — skips commune discovery; only fetches the profile pages you listed.

#### Run via API

Replace `YOUR_API_TOKEN` and start a run programmatically:

```bash
curl -X POST "https://api.apify.com/v2/acts/corent1robert~experts-comptables-annuaire-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "cities",
    "citySlugs": ["paris", "lyon"],
    "maxProfiles": 0
  }'
````

Fetch results when the run succeeds:

```bash
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?format=json&token=YOUR_API_TOKEN"
```

Use **`maxProfiles: 0`** for no row cap. Add **`"resume": true`** on full-directory runs to continue from the last checkpoint after an abort (API-only — see [Input](#input-console-vs-api)).

#### Schedule a monthly refresh

In Apify Console → **Schedules** → create a schedule on this Actor → paste the same JSON input (e.g. **Your URLs** with your master list, or **By city** for rolling département coverage). Pair with **Integrations** (Google Sheets, webhooks, Zapier) to push new rows into your stack automatically.

#### Typical workflow with other registers

| Step | Tool | Why |
|------|------|-----|
| 1 | **This Actor** | Firm name, address, phone, profile URL from the Ordre register |
| 2 | [French Companies Scraper](https://apify.com/corent1robert/recherche-entreprises-scraper) | Match a cabinet name to **SIREN**, directors, NAF code, legal form |
| 3 | [French Establishments Scraper](https://apify.com/corent1robert/french-establishments-scraper) | One row per **SIRET** / branch when you have the SIREN |
| 4 | [BODACC Legal Announcements](https://apify.com/corent1robert/bodacc-announcements-scraper) | Creation, insolvency, or sale events tied to a **SIREN** |

***

### What does it extract?

| Category | Fields |
|----------|--------|
| **Identity** | Firm name (`name`), register ID (`searchId`) |
| **Location** | Street address, postal code, city, latitude / longitude |
| **Contact** | Phone (from JSON-LD on profile pages) |
| **Web & social** | Website, LinkedIn, Facebook — when linked on the profile |
| **Profile extras** | Spoken languages, competences — when shown in HTML |
| **Links** | Canonical **profile URL**, discovery commune slug (`citySlug`) |
| **Metadata** | `scrapedAt`; `scrapeError` if a row failed partially |

**Output shape:** one row per **firm record** in the Dataset (the register lists cabinets by commune of attachment — not unique individuals). Deduplication uses **`searchId`**.

***

### Typical fill rates

Benchmark on a **Rodez** sample (30 firms, June 2026):

| Field | Fill rate |
|-------|-----------|
| `name`, `streetAddress`, `postalCode`, `city`, `profileUrl`, `phone`, `latitude`, `longitude` | **100%** |
| `languages` | **100%** (Rodez — varies by commune) |
| `website` | **~20%** |
| `linkedinUrl` | **~7%** |
| `facebookUrl` | **~3%** |
| `competences` | **0%** in Rodez sample |
| `email` | **Not available** (contact button uses a separate UI flow) |

On a **100-firm slice** from Paris, Lyon, Marseille, Toulouse, and Rodez: core address and phone **100%**; `website` **~14%**; LinkedIn **~6%**.

Full-directory runs deduplicate by `searchId` across communes. Expect **~22k–31k unique rows** after deduplication depending on how the register maps cabinets to communes.

***

### Three modes (JSON reference)

#### Full directory

```json
{
  "mode": "fullDirectory",
  "maxProfiles": 0,
  "maxCities": 0
}
```

Use `maxCities: 5` (API) to cap communes during testing.

#### By city

```json
{
  "mode": "cities",
  "citySlugs": ["paris", "lyon", "rodez"],
  "maxProfiles": 0
}
```

Slug = last segment of `https://annuaire.experts-comptables.org/recherche/ville/{slug}`.

#### Your URLs

```json
{
  "mode": "bulkUrls",
  "profileUrls": [
    "https://annuaire.experts-comptables.org/expert-comptable/12346-douls-associes-rodez-12000"
  ]
}
```

***

### How it works

1. **Commune list** (full directory only) — walks the official regional index to build ~4 600 commune slugs.
2. **Map scan** — for each commune, reads the public map API and collects firm IDs (`searchId`).
3. **Deduplication** — merges IDs seen across communes before export.
4. **Profile export** — for each firm: resolves the canonical profile URL (marker step when needed), fetches the profile page, parses JSON-LD + HTML panels.
5. **Dataset** — pushes each row immediately (`pushData`) so you see results during long runs.
6. **Optional checkpoint** — with `"resume": true`, communes already scanned and firms already exported are skipped on the next run.

HTTP-only — no browser. Cloud runs use a two-stage export pipeline (marker + profile workers) for throughput.

***

### Input (Console vs API)

| Console field | Purpose |
|---------------|---------|
| **Mode** | Full directory / By city / Your URLs |
| **Commune slug(s)** | By city — e.g. `paris`, `aix-en-provence` |
| **Profile URL(s)** | Your URLs — one official profile link per line |
| **Max firms** | Row cap; **0** = no cap |
| **Max communes** | Full directory only; **0** = all communes (hidden in Console — use API) |

**API-only options:** `resume`, `verboseLogs`, `mapConcurrency`, `maxConcurrency` / marker+profile workers (auto-tuned on cloud), `proxyConfiguration`, `maxRequestRetries`, `navigationTimeoutSecs`, `checkpointEveryCommunes`.

***

### Progress during a run

Every ~8 seconds you get one **`Progress:`** log line and a **short Console status** (they differ on purpose):

| Phase | Example log | Example status |
|-------|-------------|----------------|
| Commune list | `Building commune list · departments 40/100 (40%) · ~11s` | `Building commune list — 40%` |
| Scan + save | `Scanning communes · 1610/4675 (34%) · 9063 firms found · 3132 saved to dataset` | `Scanning France — 34% · 3132 firms saved` |
| Export finish | `Exporting firm profiles · 8500/31330 (27%) · 22830 remaining · ~18m left` | `Exporting profiles — 27% · 8500/31330 firms` |

During the **scan** phase, export percentage is **not** shown against a partial total (that was misleading in earlier versions). After the commune scan completes, export progress uses the **final** firm count.

A **`RUN_LOG`** record in the key-value store mirrors recent lines — open it from **Output → Run log (live)**.

**Resume:** set `"resume": true` in API input to continue from the last checkpoint (`CHECKPOINT` in KV) without re-scanning communes already processed.

***

### Output sample

```json
{
  "searchId": 12346,
  "name": "DOULS & ASSOCIES",
  "streetAddress": "1, avenue du Maréchal Joffre",
  "postalCode": "12000",
  "city": "Rodez",
  "phone": "+33565687888",
  "website": "https://example-cabinet.fr",
  "linkedinUrl": null,
  "facebookUrl": null,
  "languages": "Français, Anglais",
  "competences": null,
  "profileUrl": "https://annuaire.experts-comptables.org/expert-comptable/12346-douls-associes-rodez-12000",
  "citySlug": "rodez",
  "latitude": 44.3512,
  "longitude": 2.5734,
  "scrapedAt": "2026-06-05T12:00:00.000Z"
}
```

Use `profileUrl` or `searchId` as the stable key across runs.

***

### How much does it cost to scrape experts-comptables.org?

HTTP-only — no browser — so compute stays **low** compared to Puppeteer/Playwright Actors. Residential proxy is **not** required for typical runs (optional via API).

| Scenario | Approx. rows | Approx. cost |
|----------|--------------|--------------|
| **Try for free** (default) | 50 | **< $0.01** |
| **Single large city** | 500–2 000 | **~$0.05–0.15** |
| **Regional batch** (several communes) | 1 000 | **~$0.10–0.20** |
| **Full France** | ~22k–31k | **~$0.50–2.00** |

Actual cost depends on your Apify plan (compute units, dataset storage, run duration). Profile export is ~1–2 HTTP requests per firm (marker + profile, or profile only in **Your URLs** mode).

***

### Is it legal to scrape experts-comptables.org?

This Actor accesses **public** pages from the official Ordre register — the same information visible to any visitor. You remain responsible for:

- **GDPR** and French privacy law when storing or processing personal data (e.g. phone numbers of professionals).
- **Direct marketing** rules (B2B outreach still requires legitimate interest and opt-out respect).
- **Terms of use** of annuaire.experts-comptables.org.

Use outputs for **legitimate professional purposes** — B2B services, market research, CRM enrichment — not for abusive bulk spam or resale of personal data without a legal basis.

***

### Also available — French B2B registers on Apify

Apify’s recommendation engine only links Actors in the same category. **Cross-promotion between your own Actors is manual** — these companions share the same HTTP-first, CRM-ready pattern:

| Actor | Best for |
|-------|----------|
| **[Notaires.fr Directory Scraper](https://apify.com/corent1robert/notaires-fr-annuaire-scraper)** | Official **notary** offices — same directory workflow (full France or your URLs) |
| **[French Companies · Search & SIREN Enrich](https://apify.com/corent1robert/recherche-entreprises-scraper)** | Match a firm name to **SIREN**, directors, NAF, finances from the public INSEE register |
| **[French Establishments · All Sites by SIREN](https://apify.com/corent1robert/french-establishments-scraper)** | One row per **SIRET** / branch once you have SIRENs |
| **[BODACC Legal Announcements Scraper](https://apify.com/corent1robert/bodacc-announcements-scraper)** | Company creations, insolvencies, business sales — filter by keyword or SIREN |
| **[Houzz FR Professionals Scraper](https://apify.com/corent1robert/houzz-fr-professionals-scraper)** | Architects, designers, builders on Houzz — city search + optional website enrichment |
| **[Ameli Health Directory Scraper](https://apify.com/corent1robert/ameli-practitioners-scraper)** | Doctors and health professionals by specialty and city |
| **[ANAH Syndics & Condos Registry](https://apify.com/corent1robert/annuaire-syndics-coproprietes-fr)** | Property managers (**syndics**) from the official ANAH register |

Browse the full store: **[apify.com/corent1robert](https://apify.com/corent1robert)**

***

### FAQ

**Is this affiliated with the Ordre des experts-comptables?**\
No. It automates access to **public** directory pages. You remain responsible for compliance.

**Why more markers than the ~22k figure on the site?**\
The register attaches firm records to communes; the same logical firm can appear in map data across overlapping geography. The Actor **deduplicates by `searchId`** before export.

**Why is email missing?**\
The profile page uses a *Contacter par mail* button (separate UI/API). Structured JSON-LD does not include email.

**Can I use a proxy?**\
Optional via API `proxyConfiguration`. Default runs without proxy — no blocks observed at moderate concurrency during development.

**How do I find a commune slug?**\
Open a city page on the directory, e.g. `…/recherche/ville/paris` → slug is **`paris`**.

***

### Support

Custom integrations, larger exports, or CRM wiring: **<corentin@outreacher.fr>**

***

### Local development

```bash
npm install
cp .actor/INPUT.json storage/key_value_stores/default/INPUT.json
apify run
npm test
```

Results appear under `storage/datasets/default/` locally. For heavy presets, use `apify run --input-file=./input.json`.

Debug probe:

```bash
node scripts/probe-experts-comptables.mjs --city rodez --profiles 5
```

# Actor input Schema

## `mode` (type: `string`):

**Full directory** — Best for nationwide CRM feeds and market mapping.

**By city** — Best when you target specific communes or départements.

**Your URLs** — Best to refresh contacts from profile links you already collected.

## `citySlugs` (type: `array`):

One slug per line. Example: `rodez` matches https://annuaire.experts-comptables.org/recherche/ville/rodez

## `profileUrls` (type: `array`):

Links like `https://annuaire.experts-comptables.org/expert-comptable/12346-…`

## `maxProfiles` (type: `integer`):

Stop after this many unique firms. **0** = export all firms discovered (subject to commune list and timeouts).

## `maxCities` (type: `integer`):

Cap how many communes are scanned in full directory mode. **0** = all communes in the index.

## `maxConcurrency` (type: `integer`):

Parallel profile fetches (API only). Cloud runs auto-tune to ~60 unless you set this.

## Actor input object example

```json
{
  "mode": "cities",
  "citySlugs": [
    "rodez"
  ],
  "profileUrls": [
    "https://annuaire.experts-comptables.org/expert-comptable/12346-douls-associes-rodez-12000"
  ],
  "maxProfiles": 50,
  "maxCities": 0
}
```

# Actor output Schema

## `dataset` (type: `string`):

Complete results — download as CSV, JSON, or Excel from your run.

## `overview` (type: `string`):

Key columns at a glance — firm, city, phone, website, profile link.

## `runLog` (type: `string`):

Progress while communes are scanned and firm profiles are exported.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "citySlugs": [
        "rodez"
    ],
    "profileUrls": [
        "https://annuaire.experts-comptables.org/expert-comptable/12346-douls-associes-rodez-12000"
    ],
    "maxProfiles": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/experts-comptables-annuaire-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "citySlugs": ["rodez"],
    "profileUrls": ["https://annuaire.experts-comptables.org/expert-comptable/12346-douls-associes-rodez-12000"],
    "maxProfiles": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/experts-comptables-annuaire-scraper").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 '{
  "citySlugs": [
    "rodez"
  ],
  "profileUrls": [
    "https://annuaire.experts-comptables.org/expert-comptable/12346-douls-associes-rodez-12000"
  ],
  "maxProfiles": 50
}' |
apify call corent1robert/experts-comptables-annuaire-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=corent1robert/experts-comptables-annuaire-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "French Accountants Scraper · Expert-Comptable Directory",
        "description": "Export French accounting firms from the official Ordre register: name, address, phone, website, profile URL. Run by city or nationwide. No login. No API key. Public official register. JSON, CSV, Excel for CRM and B2B prospecting.",
        "version": "2.1",
        "x-build-id": "MD7ciTNoc7J5YfD9x"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/corent1robert~experts-comptables-annuaire-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-corent1robert-experts-comptables-annuaire-scraper",
                "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/corent1robert~experts-comptables-annuaire-scraper/runs": {
            "post": {
                "operationId": "runs-sync-corent1robert-experts-comptables-annuaire-scraper",
                "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/corent1robert~experts-comptables-annuaire-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-corent1robert-experts-comptables-annuaire-scraper",
                "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": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "fullDirectory",
                            "cities",
                            "bulkUrls"
                        ],
                        "type": "string",
                        "description": "**Full directory** — Best for nationwide CRM feeds and market mapping.\n\n**By city** — Best when you target specific communes or départements.\n\n**Your URLs** — Best to refresh contacts from profile links you already collected.",
                        "default": "cities"
                    },
                    "citySlugs": {
                        "title": "Commune slug(s)",
                        "type": "array",
                        "description": "One slug per line. Example: `rodez` matches https://annuaire.experts-comptables.org/recherche/ville/rodez",
                        "items": {
                            "type": "string"
                        }
                    },
                    "profileUrls": {
                        "title": "Profile URL(s)",
                        "type": "array",
                        "description": "Links like `https://annuaire.experts-comptables.org/expert-comptable/12346-…`",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxProfiles": {
                        "title": "Max firms",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Stop after this many unique firms. **0** = export all firms discovered (subject to commune list and timeouts).",
                        "default": 0
                    },
                    "maxCities": {
                        "title": "Max communes (full directory only)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Cap how many communes are scanned in full directory mode. **0** = all communes in the index.",
                        "default": 0
                    },
                    "maxConcurrency": {
                        "title": "Profile export concurrency",
                        "minimum": 1,
                        "maximum": 80,
                        "type": "integer",
                        "description": "Parallel profile fetches (API only). Cloud runs auto-tune to ~60 unless you set this."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```