# RateMDs Patient Review & Practice Finder (`dataspryva/ratemds-patient-review-and-practice-finder`) Actor

Search RateMDs doctors by name, specialty or city, or fetch known profiles directly, with ratings, review counts, practice contact details and recent patient reviews.

- **URL**: https://apify.com/dataspryva/ratemds-patient-review-and-practice-finder.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

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/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

## RateMDs Doctor, Practice & Patient Review Finder

RateMDs publishes patient ratings, reviews and practice details for doctors and clinics across the US and Canada. This actor searches that directory by name, keyword, specialty, city or state, browses practices, or fetches profiles you already know — without cookies, logins or API keys.

### Modes

| Mode | What it returns |
| --- | --- |
| `search` | Doctors matching a name/keyword, optionally narrowed by specialty, city, state, country and profile filters. |
| `bySpecialty` | Every doctor listed under a medical specialty, optionally narrowed by location. |
| `doctorProfile` | One full doctor profile from a slug or URL, including reviews. |
| `byUrl` | A batch of doctor profile URLs in one run. |
| `practiceSearch` | Practices (clinics) in a city/state, with optional per-practice details. |
| `practiceProfile` | One or more practice profiles from clinic URLs, including doctors and reviews. |

### Output per doctor

| Field | Description |
| --- | --- |
| `recordType` | `doctor` or `practice`. |
| `doctorId` | RateMDs internal doctor ID. |
| `name` / `slug` / `url` | Doctor name, URL slug and absolute profile URL. |
| `specialty` / `specialtySlug` | Human-readable and slug form of the specialty. |
| `gender` | `M` or `F` when RateMDs publishes it. |
| `verified` | Whether RateMDs marks the profile verified. |
| `rating` / `reviewCount` | Average star rating (1.0–5.0) and total review count. |
| `ratingBreakdown` | `staff`, `punctuality`, `helpfulness`, `knowledge` sub-ratings when available. |
| `photoUrl` | Absolute profile photo URL. |
| `address` / `suite` / `city` / `state` / `country` / `postalCode` | Primary practice location. |
| `latitude` / `longitude` | Practice coordinates when published. |
| `phone` / `website` | Practice contact details. |
| `clinicName` / `clinicId` / `clinicUrl` | Primary practice name, ID and RateMDs page. |
| `acceptsNewPatients` / `acceptsVirtualVisits` / `onlineScheduling` | Availability flags. |
| `sampleReview` | A sample review shown on the listing card. |
| `bio` / `languages` / `expertises` / `education` | Profile-only details when published. |
| `recentReviews` | Recent RateMDs patient reviews (`id`, `date`, `rating`, `text`, `authorLabel`, `appointmentType`, sub-ratings, `helpfulVotes`). |
| `partnerReviews` | Recent "Our Partners" reviews (same shape, `source: "partner"`). |
| `ratemdsReviewCount` / `partnerReviewCount` | Per-source review totals. |
| `scrapedAt` | ISO timestamp of capture. |

### Output per practice

`recordType`, `practiceId`, `practiceName`, `slug`, `practiceUrl`, `rank`, `locationLabel`, `address`, `suite`, `city`, `state`, `country`, `postalCode`, `phone`, `website`, `latitude`, `longitude`, `rating`, `reviewCount`, `ratingBreakdown` (`cleanliness`, `facilities`, `services`, `value`), `doctors` (id, name, URL, specialty, rating), `doctorCount`, `recentReviews`, `scrapedAt`.

Fields a profile does not publish are omitted — never filled with `null`, `0` or a placeholder.

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | Select | `search` | See the mode table. |
| `searchQuery` | Text | `cardiologist` | Doctor name, keyword or condition. |
| `specialty` | Select (66 options) | Any | Specialty browse/filter. |
| `location` | Text | – | Legacy free-text location (`New York`, `Toronto, ON`). |
| `state` / `city` | Text | – | Structured location (e.g. `ny`, `new-york`). |
| `country` | Select | Any | `us`, `ca`, `au`, `in`, `za`, `uk`. |
| `gender` | Select | `any` | `F`, `M`. |
| `verified` | Boolean | `false` | Verified profiles only. |
| `acceptingNewPatients` | Boolean | `false` | Accepting new patients only. |
| `acceptingVirtualVisits` | Boolean | `false` | Virtual visits only. |
| `onlineScheduling` | Boolean | `false` | Online booking only. |
| `openNow` | Boolean | `false` | Practices open now. |
| `doctorSlug` | Text | – | Doctor slug or URL (`doctorProfile`). |
| `profileUrls` | String list | `[]` | Doctor URLs (`byUrl`). |
| `practiceUrls` | String list | `[]` | Clinic URLs (`practiceProfile`). |
| `includeReviews` | Boolean | `false` | Fetch reviews (adds requests). |
| `includePartnerReviews` | Boolean | `false` | Fetch "Our Partners" review pages. |
| `includePracticeDetails` | Boolean | `false` | Fetch each practice page in `practiceSearch`. |
| `maxReviewPages` | Integer | `1` | Review pages per profile (10 reviews/page). |
| `maxPages` | Integer | `1000` | Listing pages per run. |
| `maxItems` | Integer | `20` | Records to emit. |

#### Examples

```json
{"mode": "search", "searchQuery": "Dr. Jane Doe", "state": "ny", "includeReviews": true, "maxItems": 5}
```

```json
{"mode": "bySpecialty", "specialty": "dermatologist", "state": "ca", "city": "los-angeles", "maxItems": 50}
```

```json
{"mode": "practiceSearch", "state": "sc", "city": "north-charleston", "includePracticeDetails": true, "maxItems": 10}
```

```json
{"mode": "doctorProfile", "doctorSlug": "45808/Dr-Paul-Natterson-Santa+Monica-CA.html", "includeReviews": true, "maxReviewPages": 3}
```

### Pagination and limits

Doctor listings normally hold 10 results per page and RateMDs caps a single query at 1,000 pages (about 10,000 doctors). When a query is larger than that, split it by state, city, specialty or one of the profile filters. Practice listings hold 10 practices per page; `locations_count` on the page gives the true total. The actor stops at `maxItems`, when the source runs out, or when `maxPages` is reached — it never stops on a wall-clock timer.

### How it works

RateMDs serves server-rendered pages with structured `window.DATA` payloads. The actor reads those payloads directly instead of brittle CSS selectors. When RateMDs returns its JavaScript proof-of-work challenge (HTTP 202), the actor solves it locally, stores the bypass cookie and retries. Requests are paced and use Apify Proxy sessions when the site rate-limits or blocks the direct connection; no proxy or cookie setup is required from you.

### FAQ

**Do I need a RateMDs account?** No. The actor reads the public pages shown to any visitor.

**Why are some fields missing?** RateMDs does not publish a website, phone, photo or sub-rating for every profile; those fields are omitted for that record.

**How many reviews can I get?** The profile page embeds the most recent page; `includeReviews` plus `maxReviewPages` walks the public review endpoint for more. `includePartnerReviews` adds partner reviews where present.

**Can I paste a full profile URL?** Yes. Both doctor and clinic URLs are accepted in the profile modes.

**Why do I see fewer rows than the site count?** A single query is capped by RateMDs at 1,000 pages. Partition by location/specialty/filter to reach the rest.

**Is this affiliated with RateMDs?** No. This is an independent tool and is not affiliated with, endorsed by, or sponsored by RateMDs.

# Actor input Schema

## `mode` (type: `string`):

What to fetch from RateMDs.

## `searchQuery` (type: `string`):

Doctor name, specialty keyword or medical condition (mode=search). Example: 'cardiologist' or 'Dr. Jane Doe'.

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

Legacy free-text location, e.g. 'New York' or 'Toronto, ON'. Used with search and bySpecialty. Structured City/State below take precedence.

## `specialty` (type: `string`):

Medical specialty to browse (mode=bySpecialty) or to narrow a keyword search.

## `state` (type: `string`):

Two-letter state/province code (e.g. 'ny', 'ca', 'on') used with search, bySpecialty and practiceSearch.

## `city` (type: `string`):

City name or slug (e.g. 'New York' or 'new-york') used with search, bySpecialty and practiceSearch.

## `country` (type: `string`):

Country filter for doctor or practice searches.

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

Filter doctors by gender when RateMDs publishes it.

## `verified` (type: `boolean`):

Only return doctors marked as verified by RateMDs.

## `acceptingNewPatients` (type: `boolean`):

Only return doctors currently accepting new patients.

## `acceptingVirtualVisits` (type: `boolean`):

Only return doctors offering virtual/telehealth appointments.

## `onlineScheduling` (type: `boolean`):

Only return doctors with online appointment booking enabled.

## `openNow` (type: `boolean`):

Only return practices that are open at the time of the run.

## `doctorSlug` (type: `string`):

A doctor's RateMDs slug or full profile URL (mode=doctorProfile). Current and legacy URL formats are accepted.

## `profileUrls` (type: `array`):

List of RateMDs doctor profile URLs or slugs to fetch.

## `practiceUrls` (type: `array`):

List of RateMDs clinic URLs or slugs to fetch, e.g. 'https://www.ratemds.com/clinic/us-sc-north-charleston-total-family-wellness/'.

## `includeReviews` (type: `boolean`):

Fetch patient reviews. For doctor search this adds one profile request per doctor; for profile modes it fetches more review pages; for practice modes it includes embedded practice reviews.

## `includePartnerReviews` (type: `boolean`):

Also fetch RateMDs 'Our Partners' reviews for doctor profiles (one extra request per review page).

## `includePracticeDetails` (type: `boolean`):

For practiceSearch, fetch each clinic page for address, phone, website, rating and doctors. Adds one request per practice.

## `maxReviewPages` (type: `integer`):

Number of review pages to fetch per doctor when reviews are enabled (10 reviews per page).

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

Maximum number of search result pages to walk per run.

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

Maximum number of records to emit.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "cardiologist",
  "location": "",
  "specialty": "",
  "state": "",
  "city": "",
  "country": "",
  "gender": "any",
  "verified": false,
  "acceptingNewPatients": false,
  "acceptingVirtualVisits": false,
  "onlineScheduling": false,
  "openNow": false,
  "profileUrls": [],
  "practiceUrls": [],
  "includeReviews": false,
  "includePartnerReviews": false,
  "includePracticeDetails": false,
  "maxReviewPages": 1,
  "maxPages": 1000,
  "maxItems": 3
}
```

# Actor output Schema

## `doctors` (type: `string`):

Dataset containing doctor and practice records from RateMDs.

# 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 = {
    "mode": "search",
    "searchQuery": "cardiologist",
    "location": "",
    "specialty": "",
    "state": "",
    "city": "",
    "country": "",
    "gender": "any",
    "verified": false,
    "acceptingNewPatients": false,
    "acceptingVirtualVisits": false,
    "onlineScheduling": false,
    "openNow": false,
    "profileUrls": [],
    "practiceUrls": [],
    "includeReviews": false,
    "includePartnerReviews": false,
    "includePracticeDetails": false,
    "maxReviewPages": 1,
    "maxPages": 1000,
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/ratemds-patient-review-and-practice-finder").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 = {
    "mode": "search",
    "searchQuery": "cardiologist",
    "location": "",
    "specialty": "",
    "state": "",
    "city": "",
    "country": "",
    "gender": "any",
    "verified": False,
    "acceptingNewPatients": False,
    "acceptingVirtualVisits": False,
    "onlineScheduling": False,
    "openNow": False,
    "profileUrls": [],
    "practiceUrls": [],
    "includeReviews": False,
    "includePartnerReviews": False,
    "includePracticeDetails": False,
    "maxReviewPages": 1,
    "maxPages": 1000,
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/ratemds-patient-review-and-practice-finder").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 '{
  "mode": "search",
  "searchQuery": "cardiologist",
  "location": "",
  "specialty": "",
  "state": "",
  "city": "",
  "country": "",
  "gender": "any",
  "verified": false,
  "acceptingNewPatients": false,
  "acceptingVirtualVisits": false,
  "onlineScheduling": false,
  "openNow": false,
  "profileUrls": [],
  "practiceUrls": [],
  "includeReviews": false,
  "includePartnerReviews": false,
  "includePracticeDetails": false,
  "maxReviewPages": 1,
  "maxPages": 1000,
  "maxItems": 3
}' |
apify call dataspryva/ratemds-patient-review-and-practice-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/ratemds-patient-review-and-practice-finder"
        }
    }
}
```

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/a1Te6P7vTjwmVJL5h/builds/AfXbJnolU6LkOkZuT/openapi.json
