Hospital Price Transparency Scraper

🏥 Hospital price transparency scraper for CMS MRFs

Hospital Price Transparency Scraper collects public CMS hospital facility data and public hospital machine-readable file (MRF) rates. Use it to export facility profiles, CPT or HCPCS billing codes, payer names, plan names, gross charges, cash prices, negotiated dollar rates, percentage rates, algorithm notes, and source MRF metadata without building your own CMS parser.

• Build a hospital price transparency dataset from public CMS facility profiles and direct MRF URLs.
• Export CMS hospital price transparency fields for compliance research, market analysis, or internal data checks.
• Compare negotiated rates for CPT or HCPCS codes across payers and plans when the hospital MRF publishes them.
• Pull cash prices, gross charges, minimum rates, and maximum rates into spreadsheets, warehouses, or BI tools.
• Schedule CMS hospital price transparency monitoring runs and send the dataset to Apify integrations or your API workflow.

📦 Returned data

Each saved item has a recordType so you can separate CMS facility profiles from MRF payer-rate charges.

Facility items can include:

• facility.ccn, facility.npi, and facility.name
• facility.address, facility.city, facility.state, facility.zipCode, and facility.county
• facility.phoneNumber
• facility.facilityType and facility.ownership
• facility.emergencyServices and facility.overallRating

Rate items can include:

• mrf.url, mrf.version, and mrf.lastUpdated
• billing.code, billing.codeType, and billing.description
• payer.name and payer.planName
• setting and methodology
• charges.gross, charges.discountedCash, charges.negotiatedDollar, charges.negotiatedPercentage, and charges.negotiatedAlgorithm
• charges.minimum, charges.maximum, charges.estimated, and charges.additionalNotes

Fields are null when the CMS source or hospital MRF does not publish that value, or when the field does not apply to that item type.

▶️ How to run it

1. Open the Actor input.
2. Fill one target section:
   • Keep or replace the prefilled public CMS example URLs in MRF file URLs.
   • Or enter a Facility state, Facility names, or CMS Certification Numbers for CMS facility profiles.
3. Optional: narrow MRF rate parsing with Billing code type, Billing codes, and Payer names.
4. Set Maximum records to control output size and cost.
5. Start the Actor and open the dataset.

You can run the Actor from Apify Console, API, schedules, webhooks, or integrations. The default dataset can be exported as CSV, JSON, Excel, XML, RSS, or HTML.

⚙️ Input

Parse one public CMS example MRF for a CPT code and payer:

{
  "mrfUrls": [
    {
      "url": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json"
    }
  ],
  "billingCodeType": "CPT",
  "billingCodes": ["70551"],
  "payerNames": ["Platform"],
  "maxRecords": 50
}

Collect CMS facility profiles in one state:

{
  "facilityState": "WY",
  "maxRecords": 50
}

📊 Output example

Facility profile:

{
  "recordType": "facility",
  "facility": {
    "ccn": "530002",
    "npi": null,
    "name": "CAMPBELL COUNTY HEALTH",
    "address": "501 SOUTH BURMA AVENUE",
    "city": "GILLETTE",
    "state": "WY",
    "zipCode": "82716",
    "county": "CAMPBELL",
    "phoneNumber": "(307) 688-1000",
    "facilityType": "Acute Care Hospitals",
    "ownership": "Government - Hospital District or Authority",
    "emergencyServices": true,
    "overallRating": 3
  },
  "mrf": null,
  "billing": null,
  "payer": null,
  "setting": null,
  "methodology": null,
  "charges": null
}

MRF payer-rate charge:

{
  "recordType": "rate",
  "facility": {
    "ccn": null,
    "npi": "0000000001,0000000002,0000000003",
    "name": "West Mercy Hospital",
    "address": "12 Main Street, Fullerton, CA  92832",
    "city": null,
    "state": "CA",
    "zipCode": null,
    "county": null,
    "phoneNumber": null,
    "facilityType": null,
    "ownership": null,
    "emergencyServices": null,
    "overallRating": null
  },
  "mrf": {
    "url": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json",
    "version": "3.0.0",
    "lastUpdated": "2026-04-01"
  },
  "billing": {
    "code": "70551",
    "codeType": "CPT",
    "description": "MRI of brain (no contrast)"
  },
  "payer": {
    "name": "Platform Health Insurance",
    "planName": "PPO"
  },
  "setting": "outpatient",
  "methodology": "fee schedule",
  "charges": {
    "gross": 1200,
    "discountedCash": 1080,
    "negotiatedDollar": 400,
    "negotiatedPercentage": null,
    "negotiatedAlgorithm": null,
    "minimum": 250,
    "maximum": 400,
    "estimated": null,
    "additionalNotes": null
  }
}

💳 Pricing

This Actor uses pay-per-event pricing. Each saved facility profile or payer-rate charge costs $0.00001 across usage tiers. Empty searches, startup, skipped inputs, parse attempts, and no-result runs are not charged as saved hospital price events.

🔌 Integrations

• Use the Apify API to start runs and fetch CMS hospital price transparency output from the default dataset.
• Schedule recurring runs to monitor public MRF files or facility lists.
• Send completed-run notifications through webhooks.
• Export data to CSV, JSON, Excel, XML, RSS, or HTML for downstream tools.

❓ FAQ

Can this actor find every hospital's MRF URL?

No. It can search CMS facility profiles and parse direct public MRF URLs you provide. It does not claim universal MRF URL discovery.

Can I scrape CMS hospital price transparency data by CPT code?

Yes, when you provide a public MRF URL that contains matching rates. Use Billing code type and Billing codes to keep matching CPT, HCPCS, MS-DRG, NDC, or other published billing-code rows.

Do I need a CMS API key, Turquoise login, or hospital account?

No. The Actor is built for public CMS facility data and public hospital MRF files. It does not need cookies, CMS API keys, Turquoise accounts, or private hospital credentials.

Why are some fields null?

CMS facility records and hospital MRF files do not always publish every field. Null values mean the source did not provide that value or the value does not apply to that item type.

Why not use the CMS API?

Use the CMS API when you only need CMS facility metadata and want to build your own pipeline. Use this Actor when you want Apify scheduling, exports, API access, and direct parsing of public hospital MRF rate files in the same workflow.

What are CMS Hospital Price Transparency alternatives?

Alternatives include downloading CMS files yourself, using hospital-hosted MRF links directly, buying healthcare pricing datasets, or using commercial tools such as Turquoise Health. This Actor is for public CMS facility data and direct public MRF files you want to run through Apify.

📝 Changelog

• 2.0: Removed derived Medicare profile URLs from output and lowered saved hospital price event pricing.
• 1.0: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Other actors

• ICD-10 Codes Scraper ↗ - Look up ICD-10-CM diagnosis codes and export official NLM Clinical Tables fields.
• Disease Outbreak News Scraper ↗ - Export official WHO, ECDC, CDC, PAHO, and CAHEC outbreak alerts.
• GLEIF LEI Lookup ↗ - Enrich company and vendor records with official Legal Entity Identifier data.
• World Bank Projects Scraper ↗ - Export public World Bank project and indicator rows for research workflows.
• OpenSSF Scorecard Projects Scraper ↗ - Export GitHub project scorecard checks for audit and risk workflows.

Made with ❤️ by Maxime Dupré