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.
Input
query requiredFree-text place query, e.g. 'Nantes', 'Saint-Etienne', 'dentiste' won't work here — this is location-only, not specialty.
Output
results requiredFAQ
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.
List Doctolib slots
List a Doctolib practitioner's bookable appointment slots for one visit motive over a window of up to 15 days (Doctolib's limit); for a longer span, call again with a later start_date. Returns name, motive, bookable, availabilities (slots by day), total, next_slot (the next slot after an empty window), visit_motives, and booking_url. A motive name that matches several motives, an unknown motive id or an unknown profile fails with a message saying what to pass; pass motive_id to target one motive exactly. booking_url only opens the booking funnel; there is no per-slot link.
List Doctolib appointments
List the appointments of the signed-in Doctolib account, upcoming or past, as the account's appointments page shows them. Each appointment has its id (the one Cancel Doctolib appointment takes), start and end date, practitioner, speciality, profile path, visit motive, patient, and whether it is confirmed, canceled, past or a no-show. Past appointments come 10 at a time, newest first: pass next_cursor back as cursor for the next ones, until it comes back null. Doctolib removes old appointments from the history after some years. No appointment returns an empty list.
