logoPandorLabs
Sign inBook a demo
Lead Generation

Doctors & Health Professionals (France)

Every registered health professional in France — doctors of every specialty, pharmacists, midwives, dentists, nurses and more — with national practitioner ID, practice site, address, phone, SIRET and FINESS.

doctors-francelead-generationhealthcaredoctorsfrancepublic-record

2,265,790 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/doctors-france/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 2,265,790 rows, this download costs 22,658 credits when the data is fresh enough, or 45,316 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/doctors-france/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "specialties": [        "SM10"      ],      "cities": [        "paris"      ],      "departments": [        "75",        "92",        "06"      ],      "communeCodes": [        "75116",        "92051"      ]    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

  • specialties

    enum[]

    Specialties

    Ordinal specialty codes (`Code savoir-faire`). Empty pulls every profession and specialty in the register. "Chirurgien esthétique" is not a legal title in France — the qualified surgeons are SM10. Any other code can be typed in through the JSON options.

    Default
    none
    Allowed values
    SM10
    SM15
    SM06
    SM07
    SM68
    SM39
    SM19
  • cities

    enum[]

    Cities

    Paris, Lyon and Marseille include every arrondissement. Empty means the whole country, unless communes or départements are set.

    Default
    none
    Allowed values
    paris
    marseille
    lyon
    toulouse
    nice
    nantes
    montpellier
    strasbourg
    bordeaux
    lille
    rennes
    reims
    toulon
    saint-etienne
    le-havre
    grenoble
    dijon
    angers
    nimes
    villeurbanne
    aix-en-provence
    clermont-ferrand
    brest
    tours
    amiens
    limoges
    annecy
    perpignan
    metz
    besancon
    orleans
    rouen
    caen
    nancy
    pau
    cannes
    antibes
    boulogne-billancourt
    neuilly-sur-seine
  • departments

    string[]

    Départements

    Two-digit codes (2A/2B for Corsica, three digits overseas). Combined with cities as an OR.

    Default
    none
    Example
    75, 92, 06
  • communeCodes

    string[]

    INSEE commune codes

    For towns the city list does not cover. INSEE codes, not postal codes.

    Default
    none
    Example
    75116, 92051
  • requireAddress

    boolean

    Require a practice address

    Registered professionals with no declared activity site (retired, between posts, abroad) have no address and are dropped.

    Default
    false
  • liberalOnly

    boolean

    Private practice only

    Keeps activities declared as libéral. Hospital-salaried surgeons are dropped — they rarely do elective aesthetic work.

    Default
    false
  • requirePhone

    boolean

    Require a phone number

    Default
    false

Advanced

  • maxRecords

    number

    Max activities per run

    Default
    10000000
    Range
    1 to 10000000
  • source

    enum

    Source

    Auto streams the full register file when nothing narrows the run server-side, and pages the filtered API when a specialty or city is set.

    Default
    auto
    Allowed values
    auto
    file
    api
  • pageSize

    number

    Page size

    API source only. The data.gouv tabular API caps a page at 200.

    Default
    200
    Range
    1 to 200
  • requestDelayMs

    number

    Delay between requests (ms)

    Default
    100
    Range
    0 to 30000
Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema
{  "type": "object",  "additionalProperties": false,  "properties": {    "specialties": {      "type": "array",      "items": {        "type": "string",        "enum": [          "SM10",          "SM15",          "SM06",          "SM07",          "SM68",          "SM39",          "SM19"        ]      },      "uniqueItems": true,      "title": "Specialties",      "description": "Ordinal specialty codes (`Code savoir-faire`). Empty pulls every profession and specialty in the register. \"Chirurgien esthétique\" is not a legal title in France — the qualified surgeons are SM10. Any other code can be typed in through the JSON options.",      "default": []    },    "cities": {      "type": "array",      "items": {        "type": "string",        "enum": [          "paris",          "marseille",          "lyon",          "toulouse",          "nice",          "nantes",          "montpellier",          "strasbourg",          "bordeaux",          "lille",          "rennes",          "reims",          "toulon",          "saint-etienne",          "le-havre",          "grenoble",          "dijon",          "angers",          "nimes",          "villeurbanne",          "aix-en-provence",          "clermont-ferrand",          "brest",          "tours",          "amiens",          "limoges",          "annecy",          "perpignan",          "metz",          "besancon",          "orleans",          "rouen",          "caen",          "nancy",          "pau",          "cannes",          "antibes",          "boulogne-billancourt",          "neuilly-sur-seine"        ]      },      "uniqueItems": true,      "title": "Cities",      "description": "Paris, Lyon and Marseille include every arrondissement. Empty means the whole country, unless communes or départements are set.",      "default": []    },    "departments": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Départements",      "description": "Two-digit codes (2A/2B for Corsica, three digits overseas). Combined with cities as an OR.",      "default": [],      "examples": [        "75, 92, 06"      ]    },    "communeCodes": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "INSEE commune codes",      "description": "For towns the city list does not cover. INSEE codes, not postal codes.",      "default": [],      "examples": [        "75116, 92051"      ]    },    "requireAddress": {      "type": "boolean",      "title": "Require a practice address",      "description": "Registered professionals with no declared activity site (retired, between posts, abroad) have no address and are dropped.",      "default": false    },    "liberalOnly": {      "type": "boolean",      "title": "Private practice only",      "description": "Keeps activities declared as libéral. Hospital-salaried surgeons are dropped — they rarely do elective aesthetic work.",      "default": false    },    "requirePhone": {      "type": "boolean",      "title": "Require a phone number",      "default": false    },    "maxRecords": {      "type": "number",      "minimum": 1,      "maximum": 10000000,      "title": "Max activities per run",      "default": 10000000    },    "source": {      "type": "string",      "enum": [        "auto",        "file",        "api"      ],      "title": "Source",      "description": "Auto streams the full register file when nothing narrows the run server-side, and pages the filtered API when a specialty or city is set.",      "default": "auto"    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 200,      "title": "Page size",      "description": "API source only. The data.gouv tabular API caps a page at 200.",      "default": 200    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between requests (ms)",      "default": 100    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/doctors-france/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "specialties": [        "SM10"      ],      "cities": [        "paris"      ],      "departments": [        "75",        "92",        "06"      ],      "communeCodes": [        "75116",        "92051"      ]    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

FieldTypeCoverage
activity_keystring100%
activity_kindstring79%
activity_sectorstring78%
address_complementstring29%
address_linestring77%
citystring77%
civilitystring100%
commune_codestring77%
countrystring32%
department_codestring78%
emailstring4%
faxstring38%
finess_legal_entitystring46%
finess_sitestring46%
first_namestring100%
full_namestring100%
last_namestring100%
metrostring20%
national_idstring100%
organization_namestring78%
pharmacist_sectionstring4%
phonestring47%
phone_2string4%
postal_codestring78%
practice_modestring83%
practice_mode_labelstring83%
practice_modesarray100%
practitioner_idstring100%
professionstring100%
profession_codestring100%
professional_categorystring100%
registration_authoritystring100%
rolestring79%
sirenstring56%
siretstring56%
specialty_codestring20%
specialty_codesarray100%
specialty_labelstring20%
specialty_typestring20%
structure_idstring78%
titlestring28%
trade_namestring11%
created_atdate100%
first_seen_atdate100%
last_seen_atdate100%
source_updated_atdate100%
updated_atdate100%
_idstring100%
logoPandorLabs

© 2026 PandorLabs LLC. All rights reserved.

WhatsApp BusinessTelegram