{ "openapi": "3.0.1", "info": { "title": "Doctolib Practitioners Scraper (FR, DE, IT)", "description": "Scrape healthcare professionals from Doctolib France, Germany and Italy by speciality and city, or the whole directory: name, speciality, address with GPS, phone, RPPS, sector, payment means, languages, fees, opening hours, visit motives, photo. Public professional data only.", "version": "0.0", "x-build-id": "83wmxmfg2E4a4OKyA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~doctolib-practitioners-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-doctolib-practitioners-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/nice_dev~doctolib-practitioners-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-doctolib-practitioners-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/nice_dev~doctolib-practitioners-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-doctolib-practitioners-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Doctolib search pages (`https://www.doctolib.fr/dentiste/paris`, filters `regulationSector[]=` / `languages[]=` and `?page=` are kept) or single profile pages (`https://www.doctolib.fr/dentiste/paris/`), on doctolib.fr, doctolib.de or doctolib.it (each URL keeps its own country). When this list is not empty, the Country / Speciality / Location / Source fields are ignored; the Sector, Languages and Insurance filters still apply (added to the filters written in a search URL, whose value wins; the sector filter is for doctolib.fr URLs only, and a profile page is checked for sector and language, not for insurance). Max 1 000 URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "fr", "de", "it" ], "type": "string", "description": "Doctolib site to search: France (doctolib.fr), Germany (doctolib.de) or Italy (doctolib.it). Specialities use that site's slugs (`dentiste` / `zahnmedizin` / `odontoiatra`).", "default": "fr" }, "speciality": { "title": "Speciality", "maxLength": 100, "type": "string", "description": "Doctolib speciality slug or name: `dentiste`, `medecin-generaliste`, `Ophtalmologue`, `Kinésithérapeute`… Doctolib skills work too with the search source (`implantologue`). Germany / Italy: the site's slugs (`zahnmedizin`, `allgemeinmedizin`, `odontoiatra`, `medico-di-medicina-generale`). An unknown value gives a clear error with suggestions. Leave empty with the sitemaps source to take every speciality.", "default": "dentiste" }, "searchQueries": { "title": "More specialities", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several specialities (or skills) in one run: one search per speciality, times each location below (3 specialities × 4 locations = 12 searches, max 500). Added to **Speciality**; a profile found by several searches is saved once.", "default": [], "items": { "type": "string" } }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "City (`Paris`, `Lyon`, `Saint-Étienne`, `Berlin`, `Milano`), Paris/Lyon/Marseille district (`paris-75009`, `Paris 9e`), department or region as Doctolib names them (search source), or empty / `France` for the whole country (capped at 10 000 results per search by Doctolib: split big searches by city). Unknown places are reported, never silently widened to the whole country. Default: Paris for France, the whole country for Germany / Italy (the form shows `Paris` for every country: with Germany or Italy, leaving it as `Paris` searches the whole country).", "default": "Paris" }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: every speciality is searched in every location. Added to **Location**.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max practitioners", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of practitioners / establishments to save in the whole run (one row per Doctolib profile, deduplicated). 0 = no limit. For reference: dentists in Paris ≈ 8 100, GPs in Lyon ≈ 1 500.", "default": 100 }, "maxItemsPerQuery": { "title": "Max profiles per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for EACH search (speciality × location, or search URL), so that the first search cannot use up the whole **Max practitioners** budget. 0 = no per-search cap.", "default": 0 }, "source": { "title": "Source", "enum": [ "search", "sitemaps" ], "type": "string", "description": "`search` = Doctolib's own search engine (nearest practitioners around the place, relevance order, departments / regions, skills, sector, insurance and language filters sent to the site): 20 profiles per request, and only the profiles you asked for. `sitemaps` = Doctolib's public sitemaps: every profile whose URL names the speciality and the city (exact city, no radius; whole directory with an empty speciality and location; sector / language filters applied on the profile), much heavier for one city. See the FAQ.", "default": "search" }, "extractDetails": { "title": "Extract details", "type": "boolean", "description": "Open each profile (1 extra request per profile) for phone number, RPPS / ADELI, presentation, website, fees, opening hours, skills, diplomas, specialities, all practice locations with accessibility and transport, establishment team. Off = search-card fields only (name, speciality, address, GPS, sector, payment means, languages, photo): much faster, same price. Always on with the sitemaps source.", "default": true }, "includeVisitMotives": { "title": "Include every visit motive", "type": "boolean", "description": "One more request per bookable profile: every visit motive (`visitMotives`, `visitMotiveNames`, with the practices that offer each), every agenda (`agendas`: practice, speciality, booking switched off, phone) and every speciality. Slots: see **Next available appointment**. About 2× slower, same price.", "default": false }, "scrapeAvailability": { "title": "Next available appointment", "type": "boolean", "description": "Asks Doctolib for the open appointment slots of each bookable profile, the way its profile page does: `nextAvailableSlot` (first open slot, even beyond the week), `nextAvailableDate`, `waitTimeDays` (days to wait from the run day, 0 = today), `totalAvailableSlots` (open slots over the 7 days from the run day) and `availabilityVisitMotive` (the visit motive the slots are for: the one the search matched, else the first in-person motive of the practice). One more request per bookable profile, two for a profile found without a search card (sitemaps source, profile URL). Charged apart: event `appointment-slots` per profile saved with an open slot (a next slot, or a slot in the week); a profile without any slot (no online booking, refused query, empty agenda) is not charged for it (see Pricing). Needs **Extract details**. Slots change by the minute: they are a snapshot of the run.", "default": false }, "includeOrganizations": { "title": "Include establishments", "type": "boolean", "description": "Doctolib search results mix individual practitioners and establishments (clinics, health centres, laboratories). Turn off to keep individual practitioners only.", "default": true }, "regulationSector": { "title": "Sector (conventionnement)", "uniqueItems": true, "type": "array", "description": "France only. Keep only practitioners in these sectors (Doctolib filters on the exact code). Empty = all. Doctors are in sector 1 (`CONTRACTED_1`) or 2 (`CONTRACTED_2`, `CONTRACTED_2_WITH_OPTAM`); `CONTRACTED` (no sector) is the code of dentists and physiotherapists: for the general practitioners of Paris it keeps 2, `CONTRACTED_1` keeps 3 740 (2026-09-18). `ORGANIZATION_*` = establishments.", "items": { "type": "string", "enum": [ "CONTRACTED_1", "CONTRACTED_2", "CONTRACTED_2_WITH_OPTAM", "CONTRACTED_1_WITH_EXTRA", "NON_CONTRACTED", "CONTRACTED", "CONTRACTED_WITH_EXTRA", "ORGANIZATION_CONTRACTED", "ORGANIZATION_NON_CONTRACTED" ], "enumTitles": [ "Conventionné secteur 1", "Conventionné secteur 2 (dépassements d'honoraires)", "Conventionné secteur 2 avec OPTAM", "Conventionné secteur 1 avec droit permanent à dépassement", "Non conventionné (secteur 3)", "Conventionné, no sector (dentists, physiotherapists)", "Conventionné with permanent right to extra fees, no sector", "Establishment, conventionné", "Establishment, non conventionné" ] }, "default": [] }, "languages": { "title": "Languages spoken", "uniqueItems": true, "type": "array", "description": "Keep only practitioners speaking one of these languages (Doctolib codes). Empty = all.", "items": { "type": "string", "enum": [ "fr", "gb", "es", "it", "de", "pt", "ar", "cn", "ru", "tr", "ro", "pl", "gr", "jp", "fa", "ua", "sgn" ], "enumTitles": [ "French", "English", "Spanish", "Italian", "German", "Portuguese", "Arabic", "Chinese", "Russian", "Turkish", "Romanian", "Polish", "Greek", "Japanese", "Persian", "Ukrainian", "Sign language" ] }, "default": [] }, "insuranceSector": { "title": "Insurance sector (Germany)", "enum": [ "any", "public", "private" ], "type": "string", "description": "Germany only. Keep only practitioners who take patients of this insurance sector (Berlin general practitioners on 2026-09-17: 2 125 total, 796 public, 887 private). Doctolib France and Italy accept the filter but return every practitioner, so leave it on `Any` there. Search source only: a profile read from a sitemap carries no insurance sector.", "default": "any" }, "exactMatchOnly": { "title": "Exact speciality only", "type": "boolean", "description": "Doctolib appends 'broad match' results (related specialities and skills) after the exact matches. Turn on to stop at the last exact match.", "default": false }, "requirePhone": { "title": "With a phone number only", "type": "boolean", "description": "Keep only the profiles that show a practice phone number (read on the profile: needs **Extract details**).", "default": false }, "availabilitiesBefore": { "title": "Available within (days)", "minimum": 0, "maximum": 90, "type": "integer", "description": "Keep only the profiles with an open appointment slot within this many days of the run day (1 = today or tomorrow). 0 = no filter. Switches **Next available appointment** on: every profile kept comes with its slots, charged like that option (`appointment-slots` per profile saved). Profiles without online booking are dropped. A dropped profile is not saved; each profile checked is charged a filter fee, kept or not (see Pricing).", "default": 0 }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the profiles whose name, speciality or establishment type contains one of these words (case and accents ignored), e.g. `centre`, `laboratoire`.", "default": [], "items": { "type": "string" } }, "onlyAcceptingNewPatients": { "title": "Accepting new patients only", "type": "boolean", "description": "Keep only the practitioners whose visit motive in the search results accepts new patients (`allowsNewPatients`). Judged on the search results, before any profile request. Needs the search source; pasted profile URLs are kept (their page does not say).", "default": false }, "suppressedDoctorIds": { "title": "Suppressed profile ids", "maxItems": 10000, "type": "array", "description": "Doctolib ids (the `id` field) of profiles never to deliver — e.g. practitioners who asked to be left out of your files. Skipped before their profile is requested.", "default": [], "items": { "type": "string" } }, "suppressedDoctorSlugs": { "title": "Suppressed profile slugs", "maxItems": 10000, "type": "array", "description": "Same, by slug (the `slug` field, e.g. `vincent-bourasset`) or by profile URL.", "default": [], "items": { "type": "string" } }, "onlyNew": { "title": "Only new profiles", "type": "boolean", "description": "Skip the profiles that a previous run (same **Memory key**) already delivered: they are not saved, not charged, and not even requested. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new profiles**. Give each schedule / task its own key (e.g. `paris-dentists`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every profile again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 8 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 600, "type": "integer", "description": "Global request rate. Lower it if the site answers HTTP 429 / 403 in the log.", "default": 120 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed.", "default": 4 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }