NPI Provider Scraper

Looks up licensed US healthcare providers in the NPPES NPI Registry — the national provider directory published as open data by the Centers for Medicare & Medicaid Services. Search by specialty, location and name, and get back one flat row per provider: NPI number, name and credential, specialties, state licence, practice and mailing address, phone and fax, and when the record was last updated. Covers both individual clinicians and healthcare organizations such as hospitals, clinics, labs and pharmacies. No account or API key needed.

Input

Field	Default	Description
specialty	Dermatologist	Specialty to search for. Everyday names work (Dermatologist, Cardiologist, Pediatrician) and are mapped to the registry's own wording; registry terms such as Family Medicine or General Acute Care Hospital work too. Leave empty to search by name and location only.
location	Austin, TX	City, ST, a state name or code, or a 5-digit ZIP. Matched against each provider's primary practice address. Leave empty for a nationwide search.
last_name	(empty)	Optional last name, or organization name when provider_type is organization. A trailing * acts as a wildcard.
provider_type	individual	individual (clinicians), organization (facilities) or both.
max_results	20	Maximum rows to return, up to 1200 per search.
proxyConfiguration	Apify proxy	Optional. The registry answers directly, so a proxy is only needed if you want requests routed through one.

At least one of specialty, a city or ZIP in location, or last_name must be given — a state on its own is too broad for the registry to answer.

Output

{
  "npi": "1245421429",
  "provider_type": "Individual",
  "name": "AMMAR MOIN AHMED",
  "first_name": "AMMAR",
  "middle_name": "MOIN",
  "last_name": "AHMED",
  "credential": "MD",
  "name_prefix": "Dr.",
  "gender": "M",
  "organization_name": "",
  "specialty": "Dermatology",
  "taxonomy_code": "207N00000X",
  "taxonomy_group": "",
  "all_specialties": ["Internal Medicine, Adolescent Medicine", "Dermatology"],
  "license_number": "N4239",
  "license_state": "TX",
  "phone": "512-324-9650",
  "fax": "512-324-9653",
  "street_address": "313 E 12TH ST",
  "address_line_2": "SUITE 101",
  "city": "AUSTIN",
  "state": "TX",
  "zip_code": "78701",
  "zip_code_full": "78701-1954",
  "country": "United States",
  "full_address": "313 E 12TH ST SUITE 101, AUSTIN, TX 78701-1954",
  "mailing_street_address": "1601 RIO GRANDE ST",
  "mailing_city": "AUSTIN",
  "mailing_state": "TX",
  "mailing_zip_code": "78701",
  "sole_proprietor": "NO",
  "authorized_official": "",
  "authorized_official_title": "",
  "other_names": [],
  "status": "Active",
  "enumeration_date": "2007-08-05",
  "last_updated": "2013-01-10",
  "profile_url": "https://npiregistry.cms.hhs.gov/provider-view/1245421429",
  "raw": { "…": "the untouched registry record" }
}

Every row also carries a raw field with the registry's own record, so nothing is lost.

Notes

• Source: the NPPES NPI Registry public search service operated by the Centers for Medicare & Medicaid Services. This is US government open data and is free to use; no key, account or sign-in is involved.
• Organization rows fill organization_name, authorized_official and the address fields; the person-name and gender fields stay empty. Individual rows are the other way round.
• The registry returns a maximum of 1200 records for any single search. To collect more, split the work by city, ZIP or specialty and run the actor once per slice.
• Records reflect what each provider last filed with CMS. last_updated shows how current a row is, and status flags deactivated NPIs.
• Requests are paced about half a second apart to stay well inside the registry's fair-use expectations.