# Hospital Price Transparency Scraper (`maximedupre/hospital-price-transparency-scraper`) Actor Scrape CMS hospital facility data and public MRF payer-rate records. Export facility profiles, CPT/HCPCS codes, gross charges, cash prices, negotiated rates, payer names, and plan names. - **URL**: https://apify.com/maximedupre/hospital-price-transparency-scraper.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.90 / 1,000 scraped price records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🏥 Hospital price transparency scraper for CMS data Hospital Price Transparency Scraper collects public CMS hospital facility data and public hospital machine-readable file (MRF) rates. Use this hospital price transparency scraper to export facility profiles, CPT or HCPCS procedure codes, gross charges, discounted cash prices, payer names, plan names, negotiated dollar rates, percentage or algorithm details, and source MRF metadata. The Actor works with two practical target types. You can search the official [CMS Provider Data](https://data.cms.gov/provider-data/) hospital facility dataset by state, facility name, or CMS Certification Number. You can also paste direct public hospital MRF URLs to parse payer-rate charges. Results are saved to the default Apify dataset, where you can export CSV, JSON, Excel, XML, or call the same data through the Apify API. For a first run, keep the prefilled CMS example MRF URL, `CA` in **Facility state**, and `Maximum records` at `500`. Add a billing code or payer filter when you want a narrower MRF rate export. ### ✅ What this Actor does - Searches CMS hospital facility profiles by state, hospital name, or CMS Certification Number. - Parses direct public hospital MRF URLs for payer and procedure rates. - Supports common CMS JSON, CSV, gzip JSON, and gzip CSV MRF files when the public file follows common CMS layouts. - Filters MRF rates by billing code type, exact billing code, and payer or plan name. - Saves one dataset item per accepted facility profile or payer-rate charge. - Returns source-backed hospital identity, MRF provenance, billing codes, payer context, setting, methodology, and charge amounts when the source provides them. - Works without a CMS API key, Turquoise login, hospital account, cookies, or user-provided proxy settings. - Charges only for saved facility profiles and payer-rate charges. This Actor does not discover a direct MRF URL for every US hospital. Use the CMS facility search when you need hospital metadata, and paste direct public MRF URLs when you need charge-rate rows. ### 📦 Data you can export Each item has a `recordType` so you can filter facility profiles from payer-rate charges in a spreadsheet or warehouse. Facility rows 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` - `facility.profileUrl` Rate rows 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 can be `null` when the CMS source or hospital MRF does not publish that value. ### 🎯 Common use cases - Build a CMS hospital facility list for one state. - Join hospital identities with MRF charge data. - Compare negotiated rates for a CPT or HCPCS code across payers and plans. - Pull cash prices, gross charges, and min/max rates into a pricing analysis workflow. - Monitor public hospital price transparency files with scheduled Apify runs. - Feed source-backed hospital price data into procurement, compliance, market research, or data warehouse pipelines. ### ▶️ How to run it 1. Open the Actor input. 2. Choose one or both target sections: - Add direct public MRF URLs in **MRF file URLs**. - Add a **Facility state**, **Facility names**, or **CMS Certification Numbers** for CMS facility profiles. 3. Optional: filter MRF rates by **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, the Apify API, schedules, webhooks, or integrations. The default dataset can be exported as CSV, JSON, Excel, XML, RSS, or HTML. ### ⚙️ Input example Parse one public CMS example MRF for a CPT code and payer: ```json { "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: ```json { "facilityState": "WY", "maxRecords": 50 } ``` ### 📊 Output example Facility profile: ```json { "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, "profileUrl": "https://www.medicare.gov/care-compare/details/hospital/530002" }, "mrf": null, "billing": null, "payer": null, "setting": null, "methodology": null, "charges": null } ``` MRF payer-rate charge: ```json { "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, "profileUrl": 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. You pay for each saved facility profile or payer-rate charge. Empty searches, startup, skipped inputs, parse attempts, and no-result runs are not charged as result events. ### ⚠️ Limits and caveats - The Actor returns data exactly as public CMS sources and hospital MRF files publish it. It does not fix missing prices, missing payer names, or incomplete MRF fields. - Facility search uses public CMS facility data. It does not imply that a direct MRF URL is known for every facility. - MRF parsing works for common CMS JSON and CSV layouts. Highly custom or invalid files may produce no rows. - Private files, login-protected files, blocked downloads, and unreachable URLs are reported in logs, not as dataset rows. - This is a data extraction tool, not medical, legal, billing, or reimbursement advice. ### ❓ 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. #### Do I need a CMS API key or hospital login? No. The Actor is built for public CMS facility data and public hospital MRF files. It does not use cookies, CMS API keys, Turquoise accounts, or private hospital credentials. #### Can I filter by CPT code and payer? Yes. Use **Billing code type**, **Billing codes**, and **Payer names** to keep matching MRF rate rows before they are saved. #### 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 it does not apply to that row type. ### 📝 Changelog - 1.0: Initial release. ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~hospital-price-transparency-scraper/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Other actors - [GLEIF LEI Lookup ↗](https://apify.com/maximedupre/gleif-lei-lookup) - Enrich company and vendor records with official Legal Entity Identifier data. - [World Bank Projects Scraper ↗](https://apify.com/maximedupre/world-bank-projects-scraper) - Export public World Bank project and indicator rows for research workflows. - [Business Address Scraper ↗](https://apify.com/maximedupre/business-address-scraper) - Extract physical business addresses from public company websites. - [Yellow Pages Scraper ↗](https://apify.com/maximedupre/yellowpages-scraper) - Collect public US business listings, phone numbers, addresses, and websites. - [Website Emails Scraper ↗](https://apify.com/maximedupre/website-emails-scraper) - Find public contact emails from a list of websites. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `mrfUrls` (type: `array`): Parse public hospital machine-readable files for payer and procedure rates. ## `facilityState` (type: `string`): Find CMS hospital and facility records in one US state. ## `facilityNames` (type: `array`): Search by hospital or facility name. ## `facilityCcns` (type: `array`): Fetch known facilities by CMS Certification Number. ## `billingCodeType` (type: `string`): Filter MRF charge rows by code system. ## `billingCodes` (type: `array`): Filter rates by exact billing codes, such as CPT 70551. ## `payerNames` (type: `array`): Filter rates by payer or plan names. ## `maxRecords` (type: `integer`): Cap facility and charge rows across the whole run. ## Actor input object example ```json { "mrfUrls": [ { "url": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json" } ], "facilityState": "CA", "facilityNames": [], "facilityCcns": [], "billingCodeType": "", "billingCodes": [], "payerNames": [], "maxRecords": 500 } ``` # Actor output Schema ## `results` (type: `string`): Open one item per saved CMS facility profile or public hospital MRF payer-rate charge. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mrfUrls": [ { "url": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json" } ], "facilityState": "CA", "facilityNames": [], "facilityCcns": [], "billingCodeType": "", "billingCodes": [], "payerNames": [], "maxRecords": 500 }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/hospital-price-transparency-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mrfUrls": [{ "url": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json" }], "facilityState": "CA", "facilityNames": [], "facilityCcns": [], "billingCodeType": "", "billingCodes": [], "payerNames": [], "maxRecords": 500, } # Run the Actor and wait for it to finish run = client.actor("maximedupre/hospital-price-transparency-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mrfUrls": [ { "url": "https://raw.githubusercontent.com/CMSgov/hospital-price-transparency/master/examples/JSON/v3_json_format_example.json" } ], "facilityState": "CA", "facilityNames": [], "facilityCcns": [], "billingCodeType": "", "billingCodes": [], "payerNames": [], "maxRecords": 500 }' | apify call maximedupre/hospital-price-transparency-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/hospital-price-transparency-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hospital Price Transparency Scraper", "description": "Scrape CMS hospital facility data and public MRF payer-rate records. Export facility profiles, CPT/HCPCS codes, gross charges, cash prices, negotiated rates, payer names, and plan names.", "version": "1.0", "x-build-id": "RkOyNSXTgzXWpwooQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~hospital-price-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-hospital-price-transparency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/maximedupre~hospital-price-transparency-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-hospital-price-transparency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/maximedupre~hospital-price-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-hospital-price-transparency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mrfUrls": { "title": "MRF file URLs", "type": "array", "description": "Parse public hospital machine-readable files for payer and procedure rates.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL", "description": "Direct URL to a public CMS hospital price transparency MRF file." } } } }, "facilityState": { "title": "Facility state", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "DC" ], "type": "string", "description": "Find CMS hospital and facility records in one US state.", "default": "CA" }, "facilityNames": { "title": "Facility names", "type": "array", "description": "Search by hospital or facility name.", "items": { "type": "string", "minLength": 1 } }, "facilityCcns": { "title": "CMS Certification Numbers", "type": "array", "description": "Fetch known facilities by CMS Certification Number.", "items": { "type": "string", "minLength": 1 } }, "billingCodeType": { "title": "Billing code type", "enum": [ "", "CPT", "HCPCS", "MS-DRG", "APR-DRG", "RC", "NDC", "Internal" ], "type": "string", "description": "Filter MRF charge rows by code system.", "default": "" }, "billingCodes": { "title": "Billing codes", "type": "array", "description": "Filter rates by exact billing codes, such as CPT 70551.", "items": { "type": "string", "minLength": 1 } }, "payerNames": { "title": "Payer names", "type": "array", "description": "Filter rates by payer or plan names.", "items": { "type": "string", "minLength": 1 } }, "maxRecords": { "title": "Maximum records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap facility and charge rows across the whole run.", "default": 500 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```