US Medical & Health Professional License Scraper

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

{
  "fullName": "CRAIG ANTHONY NAPOLITANO",
  "firstName": "CRAIG ANTHONY",
  "lastName": "NAPOLITANO",
  "suffix": null,
  "licenseNumber": "W7094",
  "licenseType": "Physician License",
  "specialties": null,
  "registrationStatus": "ACTIVE",
  "licenseStatus": "NONE",
  "disciplinaryStatus": "NONE",
  "currentlyLicensed": true,
  "degree": "MD",
  "practiceAddress": "242 GREEN ST HEYWOOD CARDIOLOGY",
  "city": "GARDNER",
  "state": "MA",
  "zip": "01440",
  "yearOfBirth": "1984",
  "issueDate": "2026-06-12",
  "expirationDate": "2028-08-31",
  "registrationStatusDate": "2026-06-15",
  "licenseStatusDate": null,
  "disciplinaryStatusDate": null,
  "boardActionDate": null,
  "boardActionDescription": null,
  "matchedQuery": "CARDIOLOGY",
  "source": "US State Medical Board",
  "observedAt": "2026-08-10T14:31:46.120Z",
  "error": null
}

The most complete US medical and health professional license scraper available. It returns every field the state medical board exposes for each licensee, including the name, license number, profession, degree, registration and disciplinary status, practice address and key dates, plus any board action on record, and gives you four filters to target exactly the licensees 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 public state medical board license register, applies the filters you pass as input, paginates through the matching licensees, and writes one normalized record per licensee to the run's dataset. Each record carries the licensee identity, license number and profession, registration, license and disciplinary status, practice address, and any recorded board action. Dates are normalized to YYYY-MM-DD, currentlyLicensed is a computed boolean, and missing source values are returned as null.

Data covers the Texas state medical board register, which lists physicians and other health professionals it licenses. It is public data, so no account or API key is required.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 active licensees matching the keyword CARDIOLOGY.

{
  "searchQueries": ["CARDIOLOGY"],
  "status": "active",
  "maxLicenses": 10
}

Leave searchQueries empty to list all licenses that match the other filters. Every input field is optional; with an empty input the actor returns active licenses (default status is active, default maxLicenses is 10).

Input reference

Field	Type	Required	Default	Description
searchQueries	string[]	no	["CARDIOLOGY"]	Keywords matched across the whole record (name, profession, specialty, city). One search runs per entry. For example CARDIOLOGY, PEDIATRICS, HOUSTON. Leave empty to list all licenses matching the filters below.
professions	string[]	no	(empty)	Keep only these professions / license types (partial match). For example Physician, Physician Assistant, Respiratory Care, Radiologic Technologist.
cities	string[]	no	(empty)	Keep only licensees whose practice address is in these cities. For example HOUSTON, DALLAS, AUSTIN.
status	enum	no	active	Which licenses to return. One of active (currently licensed), inactive, or all.
maxLicenses	integer	no	10	Maximum number of licensees to collect. Minimum 1, maximum 1000000.

Filters combine with logical AND.

Output reference

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

Field	Type	Description
fullName	string	Licensee full name.
firstName	string	First name.
lastName	string	Last name.
suffix	string	Name suffix, or null.
licenseNumber	string	License number.
licenseType	string	Profession / license type.
specialties	string	Specialty, or null when none is recorded.
registrationStatus	string	Registration status.
licenseStatus	string	License status.
disciplinaryStatus	string	Disciplinary status.
currentlyLicensed	boolean	true when the licensee is currently licensed, else false.
degree	string	Degree (for example MD, DO).
practiceAddress	string	Practice street address.
city	string	Practice city.
state	string	Practice state.
zip	string	Practice ZIP.
yearOfBirth	string	Year of birth.
issueDate	string	License issue date (YYYY-MM-DD).
expirationDate	string	License expiration date (YYYY-MM-DD).
registrationStatusDate	string	Registration status date (YYYY-MM-DD).
licenseStatusDate	string	License status date (YYYY-MM-DD), or null.
disciplinaryStatusDate	string	Disciplinary status date (YYYY-MM-DD), or null.
boardActionDate	string	Board action date (YYYY-MM-DD), or null.
boardActionDescription	string	Board action description, or null when there is none.
matchedQuery	string	Search keyword that matched this record.
source	string	Data source.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searchQueries": ["CARDIOLOGY"], "status": "active", "maxLicenses": 10}):

{
  "fullName": "CRAIG ANTHONY NAPOLITANO",
  "firstName": "CRAIG ANTHONY",
  "lastName": "NAPOLITANO",
  "suffix": null,
  "licenseNumber": "W7094",
  "licenseType": "Physician License",
  "specialties": null,
  "registrationStatus": "ACTIVE",
  "licenseStatus": "NONE",
  "disciplinaryStatus": "NONE",
  "currentlyLicensed": true,
  "degree": "MD",
  "practiceAddress": "242 GREEN ST HEYWOOD CARDIOLOGY",
  "city": "GARDNER",
  "state": "MA",
  "zip": "01440",
  "yearOfBirth": "1984",
  "issueDate": "2026-06-12",
  "expirationDate": "2028-08-31",
  "registrationStatusDate": "2026-06-15",
  "licenseStatusDate": null,
  "disciplinaryStatusDate": null,
  "boardActionDate": null,
  "boardActionDescription": null,
  "matchedQuery": "CARDIOLOGY",
  "source": "US State Medical Board",
  "observedAt": "2026-08-10T14:31:46.120Z",
  "error": null
}

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~usa-medical-licenses-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["CARDIOLOGY"],"status":"active","maxLicenses":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~usa-medical-licenses-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"professions":["Physician"],"cities":["HOUSTON"],"maxLicenses":100}'

Apify CLI:

apify call scrapers_lat/usa-medical-licenses-scraper \
  --input '{"professions":["Physician Assistant"],"status":"all"}'

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

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing in the source. Loosen filters (for example remove cities or set status to all), or confirm the keyword appears somewhere in the record. Zero-result runs are not charged.

Which board does this cover? The Texas state medical board register, which lists physicians and other health professionals it licenses.

How do I check for disciplinary history? Read disciplinaryStatus, boardActionDate, and boardActionDescription. When there is no action on record, those fields are returned as null, never invented.

What does currentlyLicensed mean? It is a computed boolean that is true when the registration and license status indicate the licensee is currently authorized to practice, and false otherwise.

Can I search several keywords in one run? Yes. Pass multiple entries in searchQueries; one search runs per entry and all results are merged into the dataset.

Is this an official medical board tool? No. This actor is independent and has no affiliation with any state medical board. It reads only data that is publicly available. Use it in accordance with the source's terms of service.

Related scrapers

• US Business Licenses Scraper: US business licenses with names, addresses and license types.
• USA Contractor License Scraper: US state contractor licenses with contacts and insurance.
• USA Liquor License Scraper: US liquor and alcohol licenses.
• USA FCC License Scraper: FCC radio and wireless license grants.

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 any state medical board. Accesses only publicly available data. Use in accordance with the source's terms of service.