App Logo
doctolib.fr

List Doctolib slots

List a Doctolib practitioner's bookable appointment slots over the next N days for a given visit motive. Returns name, motive, bookable, availabilities (slots by day), total, next_slot, visit_motives, and booking_url. A practitioner can expose several motives sharing one name across practices, so pass motive_id to target one exactly; booking_url only opens the funnel, there is no per-slot deep link.

Input

profile_path required

Relative path (with ?pid=practice-N) or full profile URL from search_practitioners.profile_path.

days optional

Number of days to scan from start_date. Default 14.

Default: 14
motive optional

Visit-motive name substring (case-insensitive), e.g. 'première consultation', 'vidéo'. If omitted, the first motive by display position is used. Note: a practitioner can expose several motives sharing one name (different practices/agendas) — pass motive_id to disambiguate exactly.

motive_id optional

Exact 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 optional

Optional ISO date YYYY-MM-DD lower bound. Defaults to now.

Output

bookable required
booking_url required

Entry point to Doctolib's booking funnel (motive/slot selection happens in-app; no per-slot deep link exists).

profile_path required
visit_motives required
availabilities required

Days with at least one slot. Empty if none in window (see next_slot).

name optional
total optional

Total slots in the scanned window.

motive optional
next_slot optional

Next availability beyond the window when the window is empty; null when slots exist.

Related scripts

doctolib.fr

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.

Start building not clicking

Get started for free