# Doctolib Practitioner Search API Documentation

Search public practitioner data on Doctolib by specialty and city. Filter by insurance sector and page through results. Each hit carries name, specialty, practice, address, coordinates, languages, insurance, availability_ids and profile_path for the practitioner route. Supported specialties: hautarzt, frauenarzt, allgemeinmedizin, zahnarzt, augenarzt, kinderarzt, urologe, psychotherapeut. Other slugs return 422. Costs 1 credit.

- **Documentation:** [https://scrappa.co/docs/doctolib-api/doctolib_search](https://scrappa.co/docs/doctolib-api/doctolib_search)
- **API group:** Doctolib API
- **Endpoint:** `GET https://scrappa.co/api/doctolib/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `specialty` | string | Yes | Supported slugs: hautarzt, frauenarzt, allgemeinmedizin, zahnarzt, augenarzt, kinderarzt, urologe, psychotherapeut. |
| `location` | string | Yes | City slug, e.g. berlin. |
| `insurance_type` | string | No | Insurance sector: public or private. Omit for all. |
| `page` | integer | No | 1-based page number. The upstream page is 0-based. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/doctolib/search?specialty=hautarzt&location=berlin&insurance_type=private&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "specialty": "hautarzt",
        "location": "berlin",
        "page": 1,
        "pagination": {
            "total": 539,
            "total_pages": 27
        },
        "practitioners": []
    },
    "meta": {
        "billable": true,
        "duration_ms": 123.45
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Invalid Request | The request failed validation. Not billable. |
| 502 | Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
