List Doctolib slots
Input
profile_path requiredRelative path (with ?pid=practice-N) or full profile URL from search_practitioners.profile_path.
days optionalNumber of days to read from start_date, 1 to 15 (Doctolib serves at most 15 days at once). For a longer span, call again with start_date moved forward by days. Default 14.
Default: 14motive optionalVisit-motive name substring (case-insensitive), e.g. 'première consultation', 'vidéo'. It must match exactly one of the practitioner's motives; when it matches several, the run fails and lists their ids, so pass motive_id. If omitted (and no motive_id), the first motive in Doctolib's order is used.
motive_id optionalExact visit-motive id (from search_practitioners.matched_visit_motive.id or this script's visit_motives). Takes precedence over motive; the deterministic way to target one of several same-named motives.
start_date optionalOptional ISO date YYYY-MM-DD where the window starts. Defaults to today (UTC). Use it to page through later windows.
Output
bookable requiredbooking_url requiredEntry point to Doctolib's booking funnel (motive/slot selection happens in-app; no per-slot deep link exists).
profile_path requiredvisit_motives requiredavailabilities requiredDays with at least one slot. Empty if none in window (see next_slot).
name optionaltotal optionalTotal slots in the scanned window.
motive optionalnext_slot optionalNext availability beyond the window when the window is empty; null when slots exist.
FAQ
Search Doctolib practitioners
Search Doctolib practitioners by specialty and location. Returns total, page, and providers with full_name, specialty, address, sector, payment_means, languages, telehealth, online_booking, matched_visit_motive, and profile_path. There are 20 providers per page and the order is server-ranked; profile_path (including ?pid=practice-N) is the join key for get_practitioner and list_slots.
Get current user
Report which Doctolib patient account this browser is signed in as: email and name from the account page. Being signed out is reported as a normal answer (loggedIn false), not an error, so it can be used to check a session before running other Doctolib scripts.
Doctolib location autocomplete
Resolve free-text location input (city, neighborhood, street) to Doctolib's own place suggestions. Use this before search_practitioners when a plain city name silently resolves to the wrong place (e.g. "Nantes" free text can server-side-match an unrelated city) — pick a suggestion's city/label and pass that into search_practitioners.location instead of raw user input. Does not return the internal URL slug (Doctolib assigns some slugs a disambiguating numeric suffix that isn't derivable from the label alone) — only the city name/label as Doctolib itself would display it.