# ZocDoc Scraper - Pay Per Result (`silentflow/zocdoc-scraper-ppr`) Actor

Pay-per-result ZocDoc scraper at $0.05 per result. Scrape doctors, patient reviews, and appointment availability without login. Search by specialty, location, and insurance. No compute costs - only pay for data you receive.

- **URL**: https://apify.com/silentflow/zocdoc-scraper-ppr.md
- **Developed by:** [SilentFlow](https://apify.com/silentflow) (community)
- **Categories:** Lead generation, Other
- **Stats:** 33 total users, 3 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## ZocDoc Scraper - Pay Per Result

by [SilentFlow](https://apify.com/silentflow)

Pay-per-result ZocDoc scraper. Only pay for the data you actually receive - **$0.05 per result**. Scrape doctors, patient reviews, and appointment availability without login. No compute costs, proxies included.

### Why Pay Per Result?

| Feature | Standard | Pay Per Result |
|---------|----------|---------------|
| **Pricing model** | Compute time + proxy | Per result only |
| **Cost per result** | Variable | Fixed $0.05 |
| **Proxy costs** | Extra | Included |
| **Failed runs** | Still charged | No charge |
| **Budget control** | Hard to predict | Predictable |

#### Cost examples

| Scenario | Results | Cost |
|----------|---------|------|
| 20 doctors from search | 20 | $1.00 |
| 1 doctor + 50 reviews | 51 | $2.55 |
| 100 doctors + reviews + availability | 300 | $15.00 |

### Use cases

| Industry | Application |
|----------|-------------|
| **Healthcare analytics** | Analyze doctor ratings, wait times, and patient satisfaction |
| **Market research** | Map healthcare provider distribution across regions |
| **Insurance analysis** | Track which providers accept specific insurance plans |
| **Patient experience** | Monitor review sentiment and bedside manner ratings |
| **Competitor intelligence** | Benchmark practice performance against competitors |
| **Appointment tracking** | Monitor availability trends for popular specialties |

### Input parameters

#### URL scraping

| Parameter | Type | Description |
|-----------|------|-------------|
| `startUrls` | array | ZocDoc URL(s) to scrape (search pages, doctor profiles, practice pages) |

**Supported URL types:**

- Search pages: `https://www.zocdoc.com/search?address=New+York&dr_specialty=dentist`
- Doctor profiles: `https://www.zocdoc.com/doctor/john-smith-do-123456`
- Practice pages: `https://www.zocdoc.com/practice/downtown-dental-12345`

#### Specialty search

| Parameter | Type | Description |
|-----------|------|-------------|
| `searches` | array | Specialty names to search (e.g., "Dentist", "Dermatologist") |
| `location` | string | City, state, or zip code (default: "New York, NY") |
| `insurance` | string | Insurance carrier name (optional) |

#### Sorting & filtering

| Parameter | Type | Default | Options |
|-----------|------|---------|---------|
| `sort` | string | Default | Default, BestMatch, HighestRated, SoonestAvailable |
| `dayFilter` | string | AnyDay | AnyDay, Today, Tomorrow, NextThreeDays, NextTwoWeeks |
| `gender` | string | -1 | -1 (Any), 1 (Male), 2 (Female) |
| `offersTelehealth` | boolean | false | Only telehealth providers |
| `seesChildren` | boolean | false | Only pediatric providers |

#### Limits

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxItems` | integer | 50 | Maximum total items to save |
| `maxDoctors` | integer | 20 | Maximum doctors per search |
| `maxReviews` | integer | 10 | Maximum reviews per doctor |

#### Options

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `scrapeProfiles` | boolean | true | Visit doctor profiles for detailed data |
| `skipReviews` | boolean | false | Skip review extraction |
| `skipAvailability` | boolean | false | Skip availability extraction |

#### Advanced

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `scrollTimeout` | integer | 30 | Request timeout in seconds |
| `debugMode` | boolean | false | Enable detailed logging |
| `proxy` | object | residential | Proxy configuration |

### Output data

#### Doctor example

```json
{
  "id": "123456",
  "url": "https://www.zocdoc.com/doctor/john-smith-do-123456",
  "name": "John Smith, DO",
  "firstName": "John",
  "lastName": "Smith, DO",
  "title": "DO",
  "specialty": "Dentist",
  "specialties": ["Dentist", "Cosmetic Dentistry"],
  "address": "123 Main St, Suite 200",
  "city": "New York",
  "state": "NY",
  "zipCode": "10001",
  "phone": "(212) 555-0100",
  "latitude": 40.7128,
  "longitude": -74.006,
  "overallRating": 4.8,
  "bedsideMannerRating": 4.9,
  "waitTimeRating": 4.6,
  "reviewCount": 142,
  "profilePhotoUrl": "https://d1k13df5m14swc.cloudfront.net/photos/...",
  "education": ["NYU College of Dentistry - DDS"],
  "boardCertifications": ["American Board of Dentistry"],
  "languages": ["English", "Spanish"],
  "insurancesAccepted": ["Aetna", "Blue Cross", "Cigna", "United Healthcare"],
  "gender": "Male",
  "yearsOfExperience": 15,
  "practiceName": "Downtown Dental Care",
  "bio": "Dr. Smith specializes in...",
  "isAcceptingNewPatients": true,
  "offersTelehealth": false,
  "nextAvailableDate": "2024-06-15",
  "scrapedAt": "2024-06-14T10:30:00Z",
  "dataType": "doctor"
}
```

#### Review example

```json
{
  "id": "review-1",
  "doctorName": "John Smith, DO",
  "doctorUrl": "https://www.zocdoc.com/doctor/john-smith-do-123456",
  "reviewRating": 5.0,
  "reviewBedsideManner": 5.0,
  "reviewWaitTime": 4.0,
  "reviewText": "Dr. Smith was excellent. Very thorough and took the time to explain everything.",
  "reviewDate": "2024-05-20",
  "isVerified": true,
  "scrapedAt": "2024-06-14T10:30:00Z",
  "dataType": "review"
}
```

#### Availability example

```json
{
  "doctorName": "John Smith, DO",
  "doctorUrl": "https://www.zocdoc.com/doctor/john-smith-do-123456",
  "date": "2024-06-15",
  "timeSlots": ["9:00 AM", "10:30 AM", "2:00 PM", "3:30 PM"],
  "appointmentType": "in-person",
  "locationName": "Downtown Dental Care",
  "address": "123 Main St, Suite 200",
  "scrapedAt": "2024-06-14T10:30:00Z",
  "dataType": "availability"
}
```

### Pricing

**$0.05 per result** - each doctor, review, or availability slot counts as one result.

- Proxies are **included** in the price
- You are **not charged** for failed runs
- You **only pay** for data successfully delivered to your dataset

### Integrations

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("silentflow/zocdoc-scraper-ppr").call(run_input={
    "searches": ["Dentist"],
    "location": "New York, NY",
    "maxItems": 50,
    "maxDoctors": 20,
    "maxReviews": 10,
    "sort": "HighestRated"
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    if item["dataType"] == "doctor":
        print(f"[{item['overallRating']}] {item['name']} - {item['specialty']}")
    elif item["dataType"] == "review":
        print(f"  ⭐ {item['reviewRating']}: {item['reviewText'][:80]}")
    elif item["dataType"] == "availability":
        print(f"  📅 {item['date']}: {', '.join(item['timeSlots'])}")
```

#### JavaScript

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('silentflow/zocdoc-scraper-ppr').call({
    searches: ['Dermatologist'],
    location: 'San Francisco, CA',
    maxItems: 100,
    sort: 'HighestRated'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    if (item.dataType === 'doctor') {
        console.log(`[${item.overallRating}] ${item.name} - ${item.specialty}`);
    }
});
```

### Tips for best results

1. **Use specific specialties**: Target specific specialties for focused results
2. **Set realistic limits**: Start with `maxItems: 50` to test before large scrapes
3. **Skip what you don't need**: Use `skipReviews` and `skipAvailability` to reduce costs
4. **Disable profile scraping**: Set `scrapeProfiles: false` for quick, low-cost search-only results
5. **Control costs**: Set `maxItems` to cap your spending

### FAQ

**Q: How am I charged?**
A: $0.05 per result item saved to your dataset. Each doctor, review, or availability slot = 1 result.

**Q: What if the run fails?**
A: You only pay for results successfully delivered. No charge on failure.

**Q: Can I estimate costs before running?**
A: Yes! Set `maxItems` to limit results. Cost = maxItems × $0.05. Example: 100 items = $5.00 max.

**Q: Are proxies included?**
A: Yes, residential proxies are included in the per-result price.

**Q: How does PPR compare to standard?**
A: PPR is simpler and more predictable. Standard may be cheaper for very large scrapes, but PPR has no surprise costs.

### Support

Need help? We're here for you:

- **Feature requests**: Let us know what you need
- **Custom solutions**: Contact us for enterprise integrations or high-volume needs

Check out our other scrapers: [SilentFlow on Apify](https://apify.com/silentflow)

# Actor input Schema

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

ZocDoc URL(s) to scrape directly. Supports doctor profile URLs, search result pages, and practice pages.

## `skipReviews` (type: `boolean`):

Skip scraping patient reviews when visiting doctor profiles.

## `skipAvailability` (type: `boolean`):

Skip scraping appointment availability slots.

## `searches` (type: `array`):

Specialty search terms (e.g., 'Dentist', 'Dermatologist', 'Primary Care Doctor', 'Therapist').

## `location` (type: `string`):

City, state, or zip code for doctor search (e.g., 'New York, NY', '10001', 'Los Angeles, CA').

## `insurance` (type: `string`):

Insurance carrier name to filter doctors (leave empty for all).

## `sort` (type: `string`):

Sort search results by criteria.

## `dayFilter` (type: `string`):

Filter by appointment availability day.

## `gender` (type: `string`):

Filter by provider gender preference.

## `offersTelehealth` (type: `boolean`):

Only show providers offering telehealth/video visits.

## `seesChildren` (type: `boolean`):

Only show providers who see children/pediatric patients.

## `maxItems` (type: `integer`):

The maximum total number of items (doctors + reviews + availability) to save.

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

Maximum number of doctor profiles to scrape per search or URL.

## `maxReviews` (type: `integer`):

Maximum number of reviews to scrape per doctor profile. Set to 0 to skip reviews.

## `scrapeProfiles` (type: `boolean`):

Visit each doctor's profile page for detailed information (education, bio, insurance list). Disable for faster search-only scraping.

## `scrollTimeout` (type: `integer`):

HTTP request timeout in seconds.

## `proxy` (type: `object`):

Either use Apify proxy, or provide your own proxy servers.

## `debugMode` (type: `boolean`):

Activate to see detailed logs.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.zocdoc.com/search?address=New+York%2C+NY&dr_specialty=dentist&sort_type=Default&offset=0"
    }
  ],
  "skipReviews": false,
  "skipAvailability": false,
  "searches": [
    "dentist"
  ],
  "location": "New York, NY",
  "sort": "Default",
  "dayFilter": "AnyDay",
  "gender": "-1",
  "offersTelehealth": false,
  "seesChildren": false,
  "maxItems": 50,
  "maxDoctors": 20,
  "maxReviews": 10,
  "scrapeProfiles": true,
  "scrollTimeout": 30,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "debugMode": false
}
```

# Actor output Schema

## `results` (type: `string`):

Complete ZocDoc data including: doctor profiles (name, specialty, rating, address, insurance), patient reviews (rating, text, date), and availability slots. Each item has a dataType field (doctor/review/availability).

## `resultsCSV` (type: `string`):

CSV format export for spreadsheet analysis

## `resultsExcel` (type: `string`):

Excel format export

# 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 = {
    "startUrls": [
        {
            "url": "https://www.zocdoc.com/search?address=New+York%2C+NY&dr_specialty=dentist&sort_type=Default&offset=0"
        }
    ],
    "searches": [
        "dentist"
    ],
    "location": "New York, NY",
    "sort": "Default",
    "maxItems": 50,
    "maxDoctors": 20,
    "maxReviews": 10,
    "scrollTimeout": 30,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("silentflow/zocdoc-scraper-ppr").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 = {
    "startUrls": [{ "url": "https://www.zocdoc.com/search?address=New+York%2C+NY&dr_specialty=dentist&sort_type=Default&offset=0" }],
    "searches": ["dentist"],
    "location": "New York, NY",
    "sort": "Default",
    "maxItems": 50,
    "maxDoctors": 20,
    "maxReviews": 10,
    "scrollTimeout": 30,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("silentflow/zocdoc-scraper-ppr").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 '{
  "startUrls": [
    {
      "url": "https://www.zocdoc.com/search?address=New+York%2C+NY&dr_specialty=dentist&sort_type=Default&offset=0"
    }
  ],
  "searches": [
    "dentist"
  ],
  "location": "New York, NY",
  "sort": "Default",
  "maxItems": 50,
  "maxDoctors": 20,
  "maxReviews": 10,
  "scrollTimeout": 30,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call silentflow/zocdoc-scraper-ppr --silent --output-dataset

```

## MCP server setup

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

```

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/zxzRS4QySkSBzDPsB/builds/1z7qlmaYGh5ncEaIr/openapi.json