Medicare Doctors & Clinicians Scraper - NPI & Specialty

Here is one real result, with every field the actor returns:

{
  "npi": "1023570041",
  "firstName": "MALCOLM",
  "middleName": "P",
  "lastName": "PYLES",
  "suffix": null,
  "gender": "Male",
  "credential": "MD",
  "medicalSchool": "STANFORD UNIVERSITY SCHOOL OF MEDICINE",
  "graduationYear": 2019,
  "primarySpecialty": "DERMATOLOGY",
  "secondarySpecialties": null,
  "telehealth": null,
  "groupName": "BERMAN SKIN INSTITUTE MEDICAL GROUP INC",
  "groupPacId": "0042407215",
  "groupProviderCount": 27,
  "addressLine1": "1 DANIEL BURNHAM CT",
  "addressLine2": "SUITE 350C",
  "city": "SAN FRANCISCO",
  "state": "CA",
  "zipCode": "94109-0464",
  "phone": "4157716300",
  "acceptsMedicareAssignment": true,
  "individualPacId": "7810221769",
  "enrollmentId": "I20230918003750",
  "url": "https://npiregistry.cms.hhs.gov/provider-view/1023570041",
  "source": "CMS Doctors & Clinicians",
  "observedAt": "2026-08-10T14:35:09.299Z"
}

The most complete Medicare doctors and clinicians scraper available. It returns every field the CMS Doctors and Clinicians dataset exposes, including NPI, credential, medical school and graduation year, specialty, group practice, full practice address and phone, and gives you thirteen filters to target exactly the clinicians you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries the CMS Doctors and Clinicians (Physician Compare) dataset, applies the filters you pass (specialty, state, city, ZIP, name, credential, medical school, group name, NPI, graduation year), paginates through the matching clinicians, and writes one normalized record per clinician to the run's dataset. Each record carries the NPI, name and credential, medical school and graduation year, primary and secondary specialties, group practice, full practice address, phone, and Medicare assignment status. Missing source values are returned as null.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 dermatologists practicing in California.

{
  "specialties": ["DERMATOLOGY"],
  "states": ["CA"],
  "maxProviders": 10
}

Every filter is optional and can be combined. Pass several specialties or states to scan them in one run, or look up specific clinicians by npiNumbers.

Input reference

Field	Type	Required	Default	Description
specialties	string[]	no	["DERMATOLOGY"]	Primary specialty labels, for example CARDIOLOGY, INTERNAL MEDICINE, NURSE PRACTITIONER. One run can scan several.
states	string[]	no	["CA"]	2-letter US state codes, for example CA, NY, TX. One run can scan several.
cities	string[]	no	(none)	Practice city filter, for example SAN FRANCISCO, MIAMI.
zipCodes	string[]	no	(none)	Practice ZIP code filter (5 or 9 digit).
lastName	string	no	(empty)	Keep only clinicians whose last name starts with this text.
firstName	string	no	(empty)	Keep only clinicians whose first name starts with this text.
credentials	string[]	no	(none)	Credential filter, for example MD, DO, NP, PA.
medicalSchool	string	no	(empty)	Keep only clinicians whose medical school name contains this text, for example HARVARD.
groupName	string	no	(empty)	Keep only clinicians whose group or practice name contains this text.
npiNumbers	string[]	no	(none)	Look up specific clinicians by their 10-digit NPI.
graduatedAfterYear	integer	no	(none)	Keep only clinicians who graduated in or after this year.
onlyWithPhone	boolean	no	false	When on, skip records with no published practice phone number.
maxProviders	integer	no	10	Maximum clinicians to collect. Free Apify plans are capped at 10 per run.

Output reference

One dataset item per clinician. Types: string, integer, boolean, or null when the source value is absent.

Field	Type	Description
npi	string	10-digit National Provider Identifier.
firstName	string	Clinician first name.
middleName	string	Middle name, or null.
lastName	string	Clinician last name.
suffix	string	Name suffix, or null.
gender	string	Gender as recorded by CMS.
credential	string	Credential, for example MD, DO, NP, PA.
medicalSchool	string	Medical school name.
graduationYear	integer	Year of graduation.
primarySpecialty	string	Primary Medicare specialty.
secondarySpecialties	string	Secondary specialties, or null.
telehealth	boolean	Telehealth flag when present, else null.
groupName	string	Group or practice name.
groupPacId	string	Group PAC ID.
groupProviderCount	integer	Number of clinicians in the group.
addressLine1	string	Practice street address.
addressLine2	string	Second address line, or null.
city	string	Practice city.
state	string	Practice state code.
zipCode	string	Practice ZIP code.
phone	string	Practice phone number, or null.
acceptsMedicareAssignment	boolean	true if the clinician accepts Medicare assignment.
individualPacId	string	Individual PAC ID.
enrollmentId	string	Medicare enrollment ID.
url	string	Link to the provider view.
source	string	Always CMS Doctors & Clinicians.
observedAt	string	ISO 8601 timestamp of when the record was collected.

On a failed run, a single item with a populated error field is written instead, and it is not charged.

Example output record

Real record from a live run (input {"specialties": ["DERMATOLOGY"], "states": ["CA"], "maxProviders": 10}):

{
  "npi": "1023570041",
  "firstName": "MALCOLM",
  "middleName": "P",
  "lastName": "PYLES",
  "gender": "Male",
  "credential": "MD",
  "medicalSchool": "STANFORD UNIVERSITY SCHOOL OF MEDICINE",
  "graduationYear": 2019,
  "primarySpecialty": "DERMATOLOGY",
  "groupName": "BERMAN SKIN INSTITUTE MEDICAL GROUP INC",
  "groupPacId": "0042407215",
  "groupProviderCount": 27,
  "addressLine1": "1 DANIEL BURNHAM CT",
  "addressLine2": "SUITE 350C",
  "city": "SAN FRANCISCO",
  "state": "CA",
  "zipCode": "94109-0464",
  "phone": "4157716300",
  "acceptsMedicareAssignment": true,
  "individualPacId": "7810221769",
  "enrollmentId": "I20230918003750",
  "url": "https://npiregistry.cms.hhs.gov/provider-view/1023570041",
  "source": "CMS Doctors & Clinicians",
  "observedAt": "2026-08-10T14:35:09.299Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~medicare-doctors-clinicians-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"specialties":["CARDIOLOGY"],"states":["NY"],"credentials":["MD"],"maxProviders":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~medicare-doctors-clinicians-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"specialties":["NURSE PRACTITIONER"],"states":["TX"],"onlyWithPhone":true,"maxProviders":100}'

Apify CLI:

apify call scrapers_lat/medicare-doctors-clinicians-scraper \
  --input '{"npiNumbers":["1023570041"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxProviders.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing. Confirm the specialty label is the exact Medicare label, widen the state or remove city/ZIP filters. Zero-result runs are not charged.

How do I look up one specific clinician? Pass their 10-digit NPI in npiNumbers.

Why is phone null? Not every clinician has a published practice phone in the CMS dataset. Set onlyWithPhone to true to keep only records that have one. Missing values are returned as null, never invented.

Can I scan several specialties or states at once? Yes. Pass multiple values in specialties and states; all are scanned in one run under the shared maxProviders cap.

Is this an official CMS tool? No. This actor is independent and has no affiliation with CMS or Medicare. It reads only data that is publicly available in the CMS Doctors and Clinicians dataset.

Related scrapers

• Healthgrades Doctors Scraper: US doctor profiles and ratings.
• CMS Hospitals Scraper: Medicare-certified hospitals.
• CMS Nursing Homes Scraper: Medicare-certified nursing homes.
• CMS Open Payments Scraper: Industry payments to clinicians.
• Florida MQA Health Scraper: Florida health professional licenses.
• HHS OIG Exclusions Scraper: Healthcare exclusion list.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with CMS or Medicare. Accesses only publicly available data.