# ZnanyLekarz Scraper - Doctors, Reviews & Prices (Poland) (`trev0n/znanylekarz-scraper`) Actor

Scrape doctors from ZnanyLekarz.pl - Poland's #1 doctor-booking platform. Full profiles with PWZ licence numbers, services with PLN prices, clinic addresses with GPS, NIP and every patient review. Incremental monitoring for cheap recurring runs.

- **URL**: https://apify.com/trev0n/znanylekarz-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🩺 ZnanyLekarz Scraper — Doctors, Prices & Reviews

🎯 **Turn Poland's #1 doctor-booking platform into a clean, structured dataset — in minutes, with zero manual copy-pasting.**

This scraper collects full doctor listings from **ZnanyLekarz.pl**: names and specializations, PWZ licence numbers, clinic addresses with GPS, services with **PLN prices**, phone-verified patient reviews with ratings, and much more. Search by specialization and city, or paste your own links — and export everything to Excel, Google Sheets or your CRM.

### 🚀 What Does It Do?

This scraper automatically browses ZnanyLekarz.pl and collects **structured, ready-to-use data** about doctors and clinics across Poland. No manual browsing needed — just set your filters and hit Start.

💡 **Two ways to run it:**

1. **🔍 Search Mode** — pick one or more specializations (e.g. `dermatolog`, `stomatolog`, `psycholog`) and cities (e.g. `warszawa`, `krakow`, or `online` for telemedicine). The scraper builds the searches for you and even auto-corrects common name mistakes (like `dentysta` → `stomatolog`).
2. **📋 Direct URL Mode** — paste any ZnanyLekarz search page or doctor profile link and the scraper figures out what to do with each one.

### 👥 Who Is This For?

| 🏢 Use Case                            | 💬 How It Helps                                                                     |
| -------------------------------------- | ----------------------------------------------------------------------------------- |
| 📊 **Healthcare market researchers**   | Map how many specialists work in each city, their pricing and their ratings         |
| 💼 **MedTech & clinic sales teams**    | Build targeted lead lists of doctors and clinics with locations and specializations |
| 🧠 **Reputation & sentiment analysts** | Collect thousands of dated, rated patient reviews for analysis                      |
| 💰 **Pricing & benchmarking teams**    | Compare consultation prices in PLN across specialists and neighborhoods             |
| 📣 **Recruiters & medical HR**         | Find and shortlist practitioners by specialization and location                     |
| 🏥 **Insurers & clinic networks**      | Track provider availability, telemedicine coverage and price changes over time      |

### ✨ Features

- 🩺 **Complete doctor profiles** — name, specializations, PWZ licence number, biography and photo
- 💳 **Services with PLN prices** — every listed service and its price, per clinic
- 📍 **Clinic locations with GPS** — full address, city, region and exact map coordinates
- 🧾 **Clinic tax IDs (NIP)** — where available, for verification and matching
- ⭐ **Patient reviews & ratings** — dated, phone-verified reviews with the reviewer name and star score
- 🌐 **Telemedicine support** — search `online` to map doctors offering virtual consultations
- ✅ **Smart specialization check** — mistyped a specialty? You get instant suggestions instead of an empty run
- 🎛️ **Smart Filters** — by specialization, city, number of reviews per doctor, and result limits
- 🔁 **Incremental Monitoring** — after the first run, only get what's new or changed (80–95% cheaper for recurring tracking)
- 🧹 **Deduplication** — every doctor appears once, even across promoted and paginated results
- ⚡ **Fast & Scalable** — hundreds of doctors per run, no browser overhead
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option                            | What It Does                                                                                                                                   |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 🏷️ **Specializations**            | One or more medical specialties as they appear in the site URL (e.g. `dermatolog`, `stomatolog`, `psycholog`) — validated with auto-correction |
| 🏙️ **Cities**                     | One or more cities (e.g. `warszawa`, `krakow`) — or `online` for telemedicine, or leave empty to search nationwide                             |
| 👤 **Fetch full doctor profiles** | Turn on for the complete record (PWZ, prices, reviews, NIP); turn off for the fastest, cheapest lead list                                      |
| ⭐ **Max reviews per doctor**     | How many reviews to collect per doctor (0 = all of them)                                                                                       |
| 🔁 **Incremental monitoring**     | Only emit new / changed / returning doctors on recurring runs                                                                                  |
| 🔢 **Max doctors**                | Control how many doctors to extract per run (0 = unlimited)                                                                                    |
| 🔗 **Direct URLs**                | Optionally provide specific search or profile URLs to scrape                                                                                   |

### 📦 What You Get (Output Fields)

Every doctor record includes:

#### Doctor Info

| Field           | Example                                                                         |
| --------------- | ------------------------------------------------------------------------------- |
| name            | `Ewa Saniewska`                                                                 |
| namePrefix      | `lek.`                                                                          |
| specialization  | `dermatolog`                                                                    |
| specializations | `[{ "name": "Dermatolog", "url": "/ewa-saniewska/..." }]`                       |
| licenseNumber   | `3772040`                                                                       |
| licenseLabel    | `Nr PWZ`                                                                        |
| about           | `Jestem specjalistą dermatologii i wenerologii z wieloletnim doświadczeniem...` |
| image           | `https://pixel-p2.s3.eu-central-1.amazonaws.com/doctor/avatar/...jpg`           |
| url             | `https://www.znanylekarz.pl/ewa-saniewska/dermatolog-wenerolog/warszawa`        |

#### Ratings & Reviews

| Field        | Example                                                                                                               |
| ------------ | --------------------------------------------------------------------------------------------------------------------- |
| rating       | `5`                                                                                                                   |
| reviewCount  | `798`                                                                                                                 |
| totalReviews | `798`                                                                                                                 |
| reviews      | `[{ "author": "Kasia", "rating": 5, "body": "Polecam z całego serca!", "publishedAt": "2026-07-18T12:58:43+02:00" }]` |

#### Locations & Pricing

| Field          | Example                                                                                                                                                          |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| addressCities  | `Warszawa`                                                                                                                                                       |
| addresses      | `[{ "clinicName": "Centrum Medyczne Sanmedica", "street": "Niemcewicza 17", "city": "Warszawa", "latitude": 52.221, "longitude": 20.983, "nip": "7010712467" }]` |
| services       | `[{ "name": "Konsultacja dermatologiczna", "price": 350, "priceCurrency": "zł" }]`                                                                               |
| paymentMethods | `["Gotówka", "Karta płatnicza", "Blik"]`                                                                                                                         |

#### Meta

| Field        | Example                    |
| ------------ | -------------------------- |
| doctorId     | `35110`                    |
| isPromoted   | `true`                     |
| isOnlineOnly | `false`                    |
| scrapedAt    | `2026-07-22T09:40:00.000Z` |

### 📊 Example Output

```json
{
    "doctorId": "35110",
    "name": "Ewa Saniewska",
    "namePrefix": "lek.",
    "specialization": "dermatolog",
    "specializations": [
        { "name": "Dermatolog", "url": "https://www.znanylekarz.pl/ewa-saniewska/dermatolog-wenerolog/warszawa" },
        {
            "name": "Lekarz wykonujący zabiegi medycyny estetycznej",
            "url": "https://www.znanylekarz.pl/ewa-saniewska/..."
        }
    ],
    "licenseNumber": "3772040",
    "licenseLabel": "Nr PWZ",
    "rating": 5,
    "reviewCount": 798,
    "totalReviews": 798,
    "about": "Jestem specjalistą dermatologii i wenerologii z wieloletnim doświadczeniem...",
    "image": "https://pixel-p2.s3.eu-central-1.amazonaws.com/doctor/avatar/ewa.jpg",
    "addressCities": "Warszawa",
    "addresses": [
        {
            "clinicName": "Centrum Medyczne Sanmedica",
            "street": "Niemcewicza 17",
            "city": "Warszawa",
            "province": "mazowieckie",
            "latitude": 52.2211685,
            "longitude": 20.9832726,
            "nip": "7010712467",
            "services": [
                { "name": "Konsultacja dermatologiczna", "price": 350, "priceCurrency": "zł", "priceText": "350 zł" },
                { "name": "Dermoskopia", "price": 350, "priceCurrency": "zł", "priceText": "350 zł" }
            ],
            "paymentMethods": ["Gotówka", "Karta płatnicza", "Blik"]
        },
        {
            "clinicName": "Konsultacja online",
            "street": null,
            "isOnlineOnly": true,
            "services": [{ "name": "Konsultacja online", "price": 350, "priceCurrency": "zł", "priceText": "350 zł" }],
            "paymentMethods": ["Przelew na konto"]
        }
    ],
    "reviews": [
        {
            "reviewId": "6425926",
            "author": "Kasia",
            "rating": 5,
            "body": "Trafna diagnoza. Wszystko dokładnie i miło wyjaśnione. Polecam.",
            "publishedAt": "2026-07-18T12:58:43+02:00"
        }
    ],
    "isPromoted": true,
    "isOnlineOnly": false,
    "scrapedAt": "2026-07-22T09:40:00.000Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **4 ready-made table views** to quickly browse your results:

| View                      | What It Shows                                                            |
| ------------------------- | ------------------------------------------------------------------------ |
| 📊 **Overview**           | Doctor, specialization, rating, reviews, PWZ, cities and profile link    |
| 🎯 **Lead generation**    | Contact-focused: doctor, specialization, clinic cities and profile link  |
| 🔁 **Monitoring changes** | What changed since the previous run — new, updated and returning doctors |
| 📋 **Full Details**       | Every single field — the complete dataset                                |

### ❓ FAQ

**🤔 Which website does this cover?**
ZnanyLekarz.pl — the largest doctor-booking platform in Poland, part of the Docplanner group. Only Poland is covered.

**🤔 What if I mistype a specialization?**
No problem — the scraper checks your input against the official list, auto-corrects common alternatives (like `dentysta` → `stomatolog`), and if it's still unknown you get instant "did you mean…" suggestions instead of an empty run.

**🤔 Can I collect every review for a doctor?**
Yes — set "Max reviews per doctor" to `0` and the scraper pulls the complete review history, newest first.

**🤔 Does it work for online/telemedicine doctors?**
Yes — use `online` as the city to map doctors offering virtual consultations.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. Turn on Incremental Monitoring to only pay for what changed, and schedule automatic runs on Apify with a few clicks.

**🤔 Does it work with proxies?**
It runs great with no proxy at all. For very large jobs you can plug in Apify's proxy service in one click.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (by district, minimum rating, number of reviews, insurance accepted, telemedicine only)
- 📊 Extra data fields or custom output formats
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication
- 🌐 Scraping from other doctor-booking or healthcare platforms alongside ZnanyLekarz

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from ZnanyLekarz.pl. It does not access private data, bypass authentication, or collect anything hidden behind a login. Please use the data responsibly and in compliance with applicable laws and platform terms of service.

# Actor input Schema

## `specializations` (type: `array`):

One or more medical specializations, written as the slug that appears in the znanylekarz.pl URL — e.g. <code>dermatolog</code>, <code>stomatolog</code>, <code>psycholog</code>, <code>ginekolog</code>, <code>ortopeda</code>. Free text is normalised (accents stripped, spaces → hyphens) and validated against the site's official specialization list; common alternatives are auto-corrected (e.g. <code>dentysta</code> → <code>stomatolog</code>) and unknown values are rejected with suggestions.

## `cities` (type: `array`):

Cities to search, e.g. <code>warszawa</code>, <code>krakow</code>, <code>wroclaw</code> — or <code>online</code> for telemedicine-only doctors. Leave empty to search the specialization nationwide. Free text is normalised to the site's slug (e.g. 'Kraków' → 'krakow', 'Łódź' → 'lodz').

## `startUrls` (type: `array`):

Optional. Paste any znanylekarz.pl URLs — a search-results page (e.g. https://www.znanylekarz.pl/dermatolog/warszawa) or a doctor profile. Auto-classified. When provided, these REPLACE the specialization/city fields above.

## `fetchProfileDetails` (type: `boolean`):

When enabled (default), every doctor's profile page is opened for the full record: PWZ licence number, biography, services with PLN prices, payment methods, clinic NIP and reviews. When disabled (cheapest), only the ~15 fields already on the search-result card are returned — one request per ~30 doctors.

## `maxReviewsPerDoctor` (type: `integer`):

How many patient reviews to collect per doctor (newest first). The first 10 come free with the profile page; anything above 10 is fetched in small batches of 10. Set 0 to collect ALL reviews. Requires 'Fetch full doctor profiles'.

## `maxDoctors` (type: `integer`):

Hard cap on the number of doctor records pushed to the dataset. Set 0 for unlimited.

## `maxPages` (type: `integer`):

Maximum number of search-result pages to crawl per search (~25–35 doctors per page). Pagination stops automatically at the last page; raise this to go deeper on large cities.

## `maxConcurrency` (type: `integer`):

Maximum number of parallel requests.

## `maxRequestRetries` (type: `integer`):

How many times a failed request is retried.

## `incremental` (type: `boolean`):

Track changes across runs. The first run records a baseline; later runs emit only NEW, UPDATED (e.g. new reviews, price changes) and REAPPEARED doctors — typically 80–95% cheaper for recurring monitoring of the same search.

## `stateKey` (type: `string`):

Optional. Identifier for this monitoring baseline. Leave empty to derive one automatically from the search filters. Use a fixed value to keep one baseline across config tweaks.

## `emitUnchanged` (type: `boolean`):

Incremental only. Also output doctors that did not change since the last run.

## `emitExpired` (type: `boolean`):

Incremental only. Also output doctors that disappeared from the search results since the last run, tagged EXPIRED.

## `proxyConfiguration` (type: `object`):

The platform is scrape-friendly, so NO proxy is the default (cheapest). Configure a proxy only for very large runs.

## Actor input object example

```json
{
  "specializations": [
    "dermatolog"
  ],
  "cities": [
    "warszawa"
  ],
  "fetchProfileDetails": true,
  "maxReviewsPerDoctor": 10,
  "maxDoctors": 100,
  "maxPages": 30,
  "maxConcurrency": 10,
  "maxRequestRetries": 5,
  "incremental": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `monitoring` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "specializations": [
        "dermatolog"
    ],
    "cities": [
        "warszawa"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/znanylekarz-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "specializations": ["dermatolog"],
    "cities": ["warszawa"],
}

# Run the Actor and wait for it to finish
run = client.actor("trev0n/znanylekarz-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "specializations": [
    "dermatolog"
  ],
  "cities": [
    "warszawa"
  ]
}' |
apify call trev0n/znanylekarz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/znanylekarz-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CzBUirXG8V6ZLOYI9/builds/wDsYa9FoCO3dBkUTe/openapi.json
