Doctolib France Scraper | Doctors & Clinics

Collect public Doctolib France provider profiles and search results in a structured Dataset. Start with the prefilled specialty and city search, or add public profile slugs for detailed provider records. Optional profile localization and French postal-region enrichment are available. Each delivered record keeps its source identity and completeness status.

What this Actor does

This Actor collects publicly visible Doctolib France data without an account. It supports direct public profile slugs and bounded provider searches, then normalizes the returned profile, practitioner, practice, visit-motive, public contact, booking, location, and search-result fields into Dataset records. Direct profile details can request French, English, German, or Italian source localization; the source may translate only some fields.

Optional region enrichment adds a public French administrative region to practices and search-result provider locations with valid postal codes, using one cached lookup per unique code during the run. It does not access private patient information, authenticated areas, or booking actions.

Use cases

• Build a structured directory of public healthcare providers in France.
• Enrich local healthcare research with specialties, practices, locations, and public booking indicators.
• Compare public provider search coverage across French localities.

How to use

1. Open the Actor in Apify Console.
2. Add public profile slugs, or fill in Specialties or keywords and Cities in France using the normal form fields.
3. Click Start and open the Dataset when the run finishes.

Input

Use profileSlugs for one or more public Doctolib profile identifiers, such as laurent-martini-paris. For searches, add one specialty such as dentiste or cardiologue per item in searchKeywords, and one complete French city name such as Paris or Lyon per item in searchCities. Every keyword is searched in every city; two keywords and two cities create four searches. Fill in both search lists to search for providers. Leave both lists empty when collecting only the profiles you have entered.

When several cities share a name, add the department code, for example Saint-Denis, 93. Enter city names rather than postal codes or districts. If a city cannot be identified, the run explains what to correct. An unsuccessful lookup does not create a result charge.

You can enter familiar French specialty names such as Médecin généraliste, Pédiatre, or DENTISTE; accents, capitalization, and extra spaces are accepted. Repeated terms or cities that differ only in capitalization and spacing do not create extra searches. The prefilled form searches for dentists in Paris and collects up to three results. Profile identifiers are optional.

locale selects French (fr), English (en), German (de), or Italian (it) for details from the profile list. Some fields may remain in their original language, and this setting does not translate search results. Enabling includeRegion adds the French administrative region to eligible locations. If the region is unavailable, the provider details remain available and the affected result is marked partial.

The three result limits work together. Each specialty/city search stops at its page or result limit, and the entire run stops at the overall limit. Increase the overall limit above the three-result example when you want a larger collection. These are the defaults used when a setting is omitted:

Setting	What it controls	Default	Allowed range
maxPagesPerSearch	Pages checked for each specialty/city search	5	1–50
maxResultsPerSearch	Provider results for each specialty/city search	100	1–1,000
maxTotalRecords	Results across all profiles and searches	100	1–5,000
locale	Language requested for profile details	fr	fr, en, de, it
includeRegion	Add the French administrative region	false	On or off
continueOnError	Continue with remaining profiles and searches after a lookup issue	true	On or off

With continueOnError disabled, collection stops after the first lookup issue. Results already collected remain available. Invalid input produces a partial summary explaining what to correct; collection does not start until the input is corrected.

The supported limits are 50 profile slugs, 20 keyword/city combinations, 50 pages per search, 1,000 results per search, and 5,000 total Dataset records per run.

The following example collects one specific profile, requests English where available, and includes its administrative region:

{
  "profileSlugs": [
    "laurent-martini-paris"
  ],
  "locale": "en",
  "includeRegion": true,
  "maxPagesPerSearch": 1,
  "maxResultsPerSearch": 20,
  "maxTotalRecords": 1,
  "continueOnError": true,
  "searchKeywords": [],
  "searchCities": []
}

Output

The Dataset contains one record per delivered public profile or search result. Profile records include normalized identity, specialty, practitioners, agendas, visit motives, practices, public contact fields, and booking indicators. Search-result records include the keyword, locality, page, source total, provider identity, specialty, location, public booking indicators, and public profile link.

Each record includes recordKey, sourceType, sourceInput, sourceUrl, retrievedAt, sourceStatus, isPartial, partialReason, and partialReasons. Profile records expose the requested profile.locale; when region enrichment is enabled, each eligible practice and search-result provider location exposes region.value and region.label. Use recordKey to deduplicate exports. The run summary and source-error list are available in the default Key-Value Store. A partial run keeps successfully collected records and explains the limitation in the summary; an empty or failed source does not become a successful record.

If some requested data cannot be collected, the run summary is partial, including when no results are available. Open Run summary to see how many results were collected, and Collection issues for the affected profiles or searches and any suggested corrections. Incorrect input also produces partial with an explanation; no collection starts and no results are charged. A failure to save results or the required summary can still fail the run.

The following is a complete profile item from the same one-profile input shown above:

{
  "recordType": "profile",
  "schemaVersion": 1,
  "recordKey": "profile:laurent-martini-paris",
  "sourceType": "profile",
  "sourceInput": "laurent-martini-paris",
  "sourceUrl": "https://www.doctolib.fr/medecin-generaliste/levallois-perret",
  "retrievedAt": "2026-10-23T10:36:04.670999+00:00",
  "sourceStatus": "success",
  "isPartial": false,
  "partialReason": null,
  "partialReasons": [],
  "profile": {
    "locale": "en",
    "slug": "laurent-martini-paris",
    "profile": {
      "id": "382290",
      "nameWithTitle": "Dr. Laurent Martini",
      "nameWithTitleAndDeterminer": "Dr Laurent Martini",
      "subtitle": "General Practitioner",
      "pictureReference": "u4cfeuonrt46byrjbhy2",
      "speciality": {
        "id": "2",
        "kind": "medical",
        "slug": "medecin-generaliste",
        "name": "General medicine"
      },
      "organization": false,
      "organizationStatusId": null,
      "redirectUrl": "https://www.doctolib.fr/medecin-generaliste/levallois-perret",
      "placeSlug": "levallois-perret",
      "bookableOnRequestEnabled": false,
      "selfPayerBookingEnabled": false,
      "telehealthEnabled": false,
      "isSpecialized": false,
      "ineligibleToMps": false,
      "country": "fr"
    },
    "practitioners": [
      {
        "id": "47192345",
        "profileId": "382290",
        "name": "Martini",
        "nameWithTitle": "Dr. Laurent Martini",
        "nameWithTitleAndDeterminer": "Dr Laurent Martini",
        "speciality": "General Practitioner",
        "cloudinaryPublicId": "u4cfeuonrt46byrjbhy2"
      }
    ],
    "agendas": [
      {
        "id": "2531253",
        "practiceId": "600183",
        "practitionerId": "47192345",
        "organizationId": "299750",
        "patientBaseId": "470430",
        "specialityId": "2",
        "anonymous": false,
        "bookingTemporaryDisabled": false,
        "hidePractitioner": false,
        "landlineNumber": "01 89 40 45 60",
        "visitMotiveIds": [
          "12125134",
          "13821638",
          "12125133",
          "12125137",
          "15033010",
          "15033012",
          "15033015",
          "15895127",
          "15895124",
          "12125136",
          "15033019",
          "15033028",
          "15033137",
          "15033140",
          "13404301",
          "13404381",
          "15033025"
        ],
        "visitMotiveIdsByPracticeId": {
          "600183": [
            "12125134",
            "13821638",
            "12125133",
            "12125137",
            "15033010",
            "15033012",
            "15033015",
            "15895127",
            "15895124",
            "12125136",
            "15033019",
            "15033028",
            "15033137",
            "15033140",
            "13404301",
            "13404381",
            "15033025"
          ]
        }
      }
    ],
    "visitMotives": [
      {
        "id": "12125134",
        "name": "Initial general medicine visit",
        "position": 1,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "13821638",
        "name": "General medicine visit",
        "position": 2,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "12125133",
        "name": "General medicine follow-up visit",
        "position": 3,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "12125137",
        "name": "Emergency",
        "position": 7,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "15033010",
        "name": "Pose d'attelle cheville (fourni sur place)",
        "position": 11,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "15033012",
        "name": "pose d'attelle genou (fourni sur place)",
        "position": 12,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "15033015",
        "name": "pose d'attelle poignet/main/doigt (fourni sur place)",
        "position": 13,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "15895127",
        "name": "Bilan de prévention",
        "position": null,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "15895124",
        "name": "Bilan de santé ",
        "position": null,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490497",
        "telehealth": false
      },
      {
        "id": "12125136",
        "name": "Pediatric visit",
        "position": 4,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490498",
        "telehealth": false
      },
      {
        "id": "15033019",
        "name": "Consultation de pédiatrie à partir de 2 ans ",
        "position": 5,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490498",
        "telehealth": false
      },
      {
        "id": "15033028",
        "name": "Child - Half-year visit from 2 to 6 years",
        "position": 6,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490498",
        "telehealth": false
      },
      {
        "id": "15033137",
        "name": "Pose d'attelle cheville enfant (fourni sur place)",
        "position": null,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490498",
        "telehealth": false
      },
      {
        "id": "15033140",
        "name": "Urgence enfant",
        "position": null,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490498",
        "telehealth": false
      },
      {
        "id": "13404301",
        "name": "Dépistage COVID-19 test antigénique / TEST GRIPPE",
        "position": 8,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490504",
        "telehealth": false
      },
      {
        "id": "13404381",
        "name": "Dépistage apnée du sommeil",
        "position": 9,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490504",
        "telehealth": false
      },
      {
        "id": "15033025",
        "name": "Follow-up visit for sleep apnea",
        "position": 10,
        "specialityId": "2",
        "organizationId": "299750",
        "visitMotiveCategoryId": "490504",
        "telehealth": false
      }
    ],
    "places": [
      {
        "id": "practice-600183",
        "name": "Centre médical de Levallois ",
        "city": "Levallois-Perret",
        "zipcode": "92300",
        "latitude": 48.8905641,
        "longitude": 2.2819722,
        "address": "5 Rue Barbès",
        "practiceIds": [
          "600183"
        ],
        "slug": "levallois-perret",
        "landlineNumber": "01 89 40 45 60",
        "region": {
          "value": "ile-de-france",
          "label": "Ile De France"
        }
      },
      {
        "id": "practice-804836",
        "name": "CDS de Clichy",
        "city": "Clichy",
        "zipcode": "92110",
        "latitude": 48.9009013,
        "longitude": 2.3052896,
        "address": "63 Boulevard Jean Jaurès",
        "practiceIds": [
          "804836"
        ],
        "slug": "clichy",
        "landlineNumber": "01 89 40 70 20",
        "region": {
          "value": "ile-de-france",
          "label": "Ile De France"
        }
      }
    ]
  },
  "searchResult": null
}

Pricing

You are charged for each public profile or provider-search result delivered to the Dataset. Unsuccessful lookups, empty searches, and run summaries do not create a result charge. The base price is $1 per 1,000 results. Apify applies your account tier automatically; the actual charge is per delivered result.

Account tier	Price per result	Equivalent per 1,000 results
FREE	$0.001	$1.00
BRONZE	$0.0009	$0.90
SILVER	$0.0008	$0.80
GOLD	$0.00075	$0.75
PLATINUM	$0.00075	$0.75
DIAMOND	$0.00075	$0.75

Check the Actor's Pricing tab for the current terms.

Related Actors

Actor	Best for
Booksy Business Data Scraper	Public business listings and detailed profiles across Booksy markets.
Google Maps Business Scraper | $1 per 1,000	Broader local-business discovery, contact fields, ratings, and map context.
International Postal Address Parser & Normalizer	Normalize addresses from provider or practice exports before matching and enrichment.

Limits and data quality

Coverage is limited to public Doctolib France data returned for the supplied profiles and France locality searches. Appointment availability and slots are not collected. Public booking indicators describe provider settings and do not confirm that an appointment is available. Provider listings can change after a run.

Searches may include providers in nearby towns. A valid search can return no matches; try a different specialty or city if this happens. If a city cannot be identified, Collection issues explains what to correct. With continueOnError enabled, other searches continue. If a lookup issue prevents results from being collected, the run summary is marked partial, including when zero results are available.

Localization is applied only to direct profile details and may be incomplete by field. Region enrichment is limited to valid five-digit French postal codes and is an optional additional source lookup; unavailable enrichment is reported without removing the main record.

Searches are intentionally bounded by page, result, and total-record limits. A run can finish with partial status when a page bound, per-search result bound, global record bound, or source limitation is reached; the run summary identifies the condition. Inspect the summary and keep records whose sourceStatus is success or partial according to your workflow. Use stable recordKey values when merging repeated exports.

Frequently asked questions

Does this Actor require a Doctolib account?

No. It is designed for publicly visible France records and does not accept or request account credentials.

Does it book appointments?

No. It only reads public profile, search, and practice information. It never submits a booking or changes provider data.

Does locale translate every field?

No. It requests a supported source language for direct profile details, but the public response can retain source-language text for fields without a translation.

What does region enrichment add?

When enabled, it adds a broad French administrative region to eligible practices and search-result provider locations. It does not replace the original postal code, city, or address.

Can I collect all countries or private patient data?

No. This Actor is limited to public Doctolib France records. It is not a patient-data or authenticated-area collector.

Responsible use

Use the Actor only for lawful, public-data purposes. You are responsible for complying with applicable privacy, data-protection, healthcare, copyright, and source terms, and for respecting any restrictions that apply to your intended use of provider information.

Support

If a run does not produce the expected public records, open an issue in the Actor's Issues tab and include a reproducible input and the Apify run ID. Do not include credentials, private patient information, or other sensitive data in a support request.