# Doctolib Scraper - Low-cost๐ฒ๐ฅ๐จโโ๏ธ๐ฅ (`delectable_incubator/doctolib-scraper-low-cost`) Actor
Scrape doctor profiles from Doctolib ๐จโโ๏ธ๐ฅ across Europe ๐ซ๐ท๐ฉ๐ช๐ฎ๐น with a powerful healthcare scraper. Extract practitioner names, specialties, locations, details, and more. Ideal for healthcare platforms, clinics, recruiters, lead generation, market research and medical directory datasets ๐๐
- **URL**: https://apify.com/delectable\_incubator/doctolib-scraper-low-cost.md
- **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.00005 / actor start
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
---
## Doctolib Doctors Scraper ๐ฅ๐
๐จโโ๏ธ
The Doctolib Doctors Scraper is a powerful and scalable Apify Actor designed to extract structured doctor profiles, medical practice information, ratings, reviews, and appointment availability directly from Doctolib search results.
It enables healthcare market research, doctor discovery, appointment monitoring, medical recruitment, healthcare analytics, lead generation, AI training datasets, and structured healthcare data collection from one of Europe's leading medical appointment platforms.
---
### ๐ฏ What This Scraper Does
Simply provide a country, city, medical specialty, and maximum number of profiles to collect.
The scraper automatically discovers and extracts matching healthcare professionals and medical practices.
โ
Extracts doctors and medical practices from Doctolib
โ
Supports France, Germany, and Italy
โ
Searches by city or location
โ
Searches by medical speciality
โ
Extracts ratings and review counts
โ
Collects appointment availability information
โ
Detects available appointment slots
โ
Supports configurable profile limits
โ
Generates structured healthcare datasets
โ
Ready for analytics and research workflows
โ
Export-ready output format
---
### ๐ Supported Countries
| Country | Domain | Code |
| ------------ | ----------- | ---- |
| ๐ซ๐ท France | doctolib.fr | `fr` |
| ๐ฉ๐ช Germany | doctolib.de | `de` |
| ๐ฎ๐น Italy | doctolib.it | `it` |
---
### ๐ Data Extracted
#### ๐จโโ๏ธ Doctor Information
| Field | Description |
| ------------------------ | --------------------------- |
| ๐ `doctorId` | Unique doctor identifier |
| ๐จโโ๏ธ `doctorName` | Doctor name |
| ๐ฉบ `speciality` | Medical specialty |
| โญ `rating` | Average rating |
| ๐ฌ `reviewCount` | Number of reviews |
| ๐ `city` | Doctor city |
| ๐
`totalAvailableSlots` | Available appointment slots |
| ๐ `profileUrl` | Doctor profile URL |
---
### ๐ How to Use
#### 1๏ธโฃ Configure Input
Provide your search parameters:
````
{
"country": "fr",
"location": "paris",
"speciality": "dentiste",
"max\_items": 50
}
```
#### 2๏ธโฃ Run the Actor
โข Searches Doctolib for matching doctors
โข Processes search result pages automatically
โข Extracts doctor profiles and metadata
โข Collects ratings and reviews
โข Retrieves appointment availability
โข Applies profile limits
โข Stops automatically when limits are reached
#### 3๏ธโฃ Export the Dataset
Download your results in multiple formats:
โ
JSON
โ
CSV
โ
Excel
โ
XML
โ
HTML
---
### โ๏ธ Input Configuration
#### ๐ฅ Input Example
```
{
"country": "fr",
"location": "paris",
"speciality": "dentiste",
"max\_items": 50
}
```
#### Input Fields
| Field | Type | Description |
| ------------ | ------- | ---------------------------------------- |
| `country` | string | Doctolib country code (`fr`, `de`, `it`) |
| `location` | string | City or area to search |
| `speciality` | string | Medical speciality |
| `max_items` | integer | Maximum number of profiles to collect |
---
### ๐ค Output Example
```
{
"doctorId": "DTLB-987654",
"doctorName": "Dr. Marie Dupont",
"speciality": "Dentiste",
"rating": "4.8",
"reviewCount": 215,
"city": "Paris",
"totalAvailableSlots": 12,
"profileUrl": "https://www.doctolib.fr/dentiste/paris/marie-dupont"
}
````
---
### ๐ Output Explanation
| Use Case | Description |
| ------------------------- | -------------------------------------------- |
| ๐ฅ Healthcare Research | Analyze healthcare providers and specialties |
| ๐
Appointment Monitoring | Track appointment availability |
| ๐ฏ Medical Recruitment | Discover healthcare professionals |
| โญ Reputation Analysis | Monitor ratings and reviews |
| ๐ Healthcare Mapping | Build location-based healthcare datasets |
| ๐ค AI & NLP Training | Generate structured healthcare datasets |
---
### ๐ Dataset Views Included
#### ๐ Overview
Doctor ID, Name, Specialty, Rating, Reviews, City, Availability and Profile URL.
#### ๐จโโ๏ธ Detailed Doctor Profiles
Complete doctor profile information including availability and profile metadata.
#### ๐ฉบ Doctors by Specialty
Grouped healthcare professionals by medical specialization.
#### ๐ Doctors by City
Grouped healthcare professionals by location.
#### โญ Top Rated Doctors
Highest-rated doctors and practices.
#### ๐
Doctors with Availability
Profiles with upcoming appointment availability.
#### ๐จ Emergency Services Available
Doctors and practices offering urgent appointments.
---
### ๐ Why Use This Scraper?
๐ฅ Collect healthcare provider information at scale
๐
Monitor appointment availability
โญ Analyze doctor ratings and reviews
๐ Search across multiple European countries
๐ Build healthcare intelligence datasets
๐ค Automation-ready structured output
๐ฆ Export data in multiple formats
๐ง Ideal for healthcare companies, researchers, recruiters, and analysts
๐ Scalable for both small and enterprise workloads
---
### โ FAQ
#### How does this scraper work?
The scraper searches Doctolib using the selected country, city, and medical specialty, then extracts doctor profiles, ratings, reviews, and availability information.
#### Which countries are supported?
Currently France, Germany, and Italy.
#### Can I search by specialty?
Yes. You can search for any supported medical specialty available on Doctolib.
#### Does the scraper collect appointment availability?
Yes. Available appointment slots and availability indicators are extracted whenever available.
#### Can I monitor doctors over time?
Yes. You can schedule recurring runs on Apify to track profile changes and availability.
#### Is the data collected live?
Yes. Data is extracted directly from Doctolib during each run.
#### What export formats are supported?
JSON, CSV, Excel, XML, and HTML.
#### Can I use the extracted data commercially?
Yes. The extracted data can be used for analytics, recruitment, research, lead generation, and commercial applications.
#### How long does a run take?
Most runs complete within minutes depending on the selected location and number of requested profiles.
---
### ๐ How to Use
1๏ธโฃ Create a free Apify account
2๏ธโฃ Open the Doctolib Doctors Scraper
3๏ธโฃ Configure country, location, and specialty
4๏ธโฃ Start the Actor
5๏ธโฃ Export your data in JSON, CSV, Excel, XML, or HTML
---
### โ ๏ธ Disclaimer
This tool is an independent solution and is not affiliated with, endorsed by, sponsored by, or connected to Doctolib.
---
### ๐ธ Pricing
This scraper runs on a **pay per events subscription model**.
You only pay for **successful runs**.
๐ณ **Price:** $12.99 / 1000 results
---
### Related Actors
If you're interested in Healthcare, Jobs, Companies, Lead Generation, Marketplace, Social Media, or Research scraping solutions, explore more tools:
*(Coming soon)*
---
### ๐ฌ Support
โญโญโญโญโญ Leave a 5-star rating if you enjoy using this scraper.
---
### ๐ PrimeScrape
Built for scalable web data extraction & automation.
Contact us for custom scraping solutions or enterprise requests via Apify or by email.
# Actor input Schema
## `country` (type: `string`):
Select the country for Doctolib domain
## `location` (type: `string`):
City or location to search (e.g., 'paris', 'berlin', 'milano')
## `specialities` (type: `array`):
List of medical specialities to search for. The scraper will run a separate search for each speciality.
Examples:
โข dentiste
โข dermatologue
โข cardiologue
โข generaliste
โข pediatre
## `maxItemsPerSpeciality` (type: `integer`):
Maximum number of doctor profiles to scrape for EACH speciality.
## Actor input object example
```json
{
"country": "fr",
"location": "paris",
"specialities": [
"dentiste"
],
"maxItemsPerSpeciality": 50
}
````
# Actor output Schema
## `overview` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"location": "paris",
"specialities": [
"dentiste"
],
"maxItemsPerSpeciality": 50
};
// Run the Actor and wait for it to finish
const run = await client.actor("delectable_incubator/doctolib-scraper-low-cost").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"location": "paris",
"specialities": ["dentiste"],
"maxItemsPerSpeciality": 50,
}
# Run the Actor and wait for it to finish
run = client.actor("delectable_incubator/doctolib-scraper-low-cost").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"location": "paris",
"specialities": [
"dentiste"
],
"maxItemsPerSpeciality": 50
}' |
apify call delectable_incubator/doctolib-scraper-low-cost --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=delectable_incubator/doctolib-scraper-low-cost",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Doctolib Scraper - Low-cost๐ฒ๐ฅ๐จโโ๏ธ๐ฅ",
"description": "Scrape doctor profiles from Doctolib ๐จโโ๏ธ๐ฅ across Europe ๐ซ๐ท๐ฉ๐ช๐ฎ๐น with a powerful healthcare scraper. Extract practitioner names, specialties, locations, details, and more. Ideal for healthcare platforms, clinics, recruiters, lead generation, market research and medical directory datasets ๐๐",
"version": "0.0",
"x-build-id": "fnBEmeKA8JoXf2gm9"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/delectable_incubator~doctolib-scraper-low-cost/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-delectable_incubator-doctolib-scraper-low-cost",
"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/delectable_incubator~doctolib-scraper-low-cost/runs": {
"post": {
"operationId": "runs-sync-delectable_incubator-doctolib-scraper-low-cost",
"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/delectable_incubator~doctolib-scraper-low-cost/run-sync": {
"post": {
"operationId": "run-sync-delectable_incubator-doctolib-scraper-low-cost",
"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",
"required": [
"country",
"location",
"specialities",
"maxItemsPerSpeciality"
],
"properties": {
"country": {
"title": "Country ๐",
"enum": [
"fr",
"de",
"it"
],
"type": "string",
"description": "Select the country for Doctolib domain",
"default": "fr"
},
"location": {
"title": "Location ๐",
"type": "string",
"description": "City or location to search (e.g., 'paris', 'berlin', 'milano')",
"default": "paris"
},
"specialities": {
"title": "Specialities (Bulk) ๐จโโ๏ธ",
"type": "array",
"description": "List of medical specialities to search for. The scraper will run a separate search for each speciality.\n\nExamples:\nโข dentiste\nโข dermatologue\nโข cardiologue\nโข generaliste\nโข pediatre",
"default": [
"dentiste"
],
"items": {
"type": "string"
}
},
"maxItemsPerSpeciality": {
"title": "Maximum Doctors Per Speciality ๐ข",
"type": "integer",
"description": "Maximum number of doctor profiles to scrape for EACH speciality.",
"default": 50
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```