# CMS Nursing Home Compare Scraper (`maximedupre/cms-nursing-home-compare-scraper`) Actor Export official CMS Nursing Home Compare facility data. Get one row per nursing home with CCN, address, ownership, beds, ratings, staffing, penalties, chain details, and source audit fields. - **URL**: https://apify.com/maximedupre/cms-nursing-home-compare-scraper.md - **Developed by:** [Maxime Duprรฉ](https://apify.com/maximedupre) (community) - **Categories:** Business, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 facility saveds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ### ๐Ÿฅ Nursing Home Compare facility data from CMS CMS Nursing Home Compare Scraper exports official CMS public nursing home facility records into a clean Apify dataset. Use it when you need facility identity, contacts, ownership, beds, ratings, compliance, staffing, penalties, chain details, and source audit fields without using a CMS account or API key. - [Build a nursing home compare dataset](https://apify.com/maximedupre/cms-nursing-home-compare-scraper/examples/cms-nursing-home-compare-scraper-nursing-home-compare-dataset) for a state, territory, or nationwide market. - [Look up specific facilities by CMS Certification Number](https://apify.com/maximedupre/cms-nursing-home-compare-scraper/examples/cms-nursing-home-compare-scraper-cms-certification-number-looku) for audits or enrichment. - [Find nursing homes by facility name, city, ZIP code, ownership, beds, ratings, or special focus status](https://apify.com/maximedupre/cms-nursing-home-compare-scraper/examples/cms-nursing-home-compare-scraper-find-nursing-homes-by-filters). - [Monitor CMS quality, inspection, staffing, and penalty facts](https://apify.com/maximedupre/cms-nursing-home-compare-scraper/examples/cms-nursing-home-compare-scraper-monitor-cms-nursing-home-quali) for compliance workflows. - [Export audit-ready facility rows](https://apify.com/maximedupre/cms-nursing-home-compare-scraper/examples/cms-nursing-home-compare-scraper-export-audit-ready-nursing-hom) for lead generation, market research, BI, or CRM enrichment. #### ๐Ÿ“ฆ What data you get Each dataset item is one successful CMS nursing home facility row. Available fields include: | Data group | Examples | | --- | --- | | Facility identity | CCN, facility name, legal business name, provider type | | Contact and location | address, city, county, state, ZIP, phone, latitude, longitude | | Facility attributes | ownership type, certified beds, average residents, first approved date | | Ratings | overall, health inspection, staffing, quality, short-stay, long-stay | | Compliance | health deficiencies, infection citations, inspection score, special focus status, abuse indicator, sprinkler systems | | Penalties | fine count, fine total, payment denial count, penalty total | | Staffing and chain | RN hours, total nurse staff hours, turnover, chain ID, chain name, chain facility count | | Source audit | CMS dataset ID, source URL, processing date, fetched timestamp, matched target | CMS fields can be blank when the source does not publish a value for a facility. The actor preserves those source-limited values as `null` instead of inventing data. #### โ–ถ๏ธ How to run 1. Choose whether to collect nationwide records, one or more states or territories, exact CCNs, or facility/location searches. 2. Add optional filters such as ownership type, special focus status, overall rating range, certified bed range, and maximum facilities. 3. Enable raw CMS source rows only if you need the original source fields for audit or debugging workflows. 4. Run the actor and open the default dataset, export it, or consume it through the Apify API. #### ๐ŸŽ›๏ธ Input options | Input | Use it for | | --- | --- | | Collect nationwide | Export all available CMS nursing home facility records. | | States or territories | Limit collection to selected state or territory codes. | | CMS certification numbers | Fetch exact facilities by CCN. | | Facility, city, or ZIP searches | Search by provider/facility name, city, or ZIP code. | | Ownership types | Filter by CMS-reported ownership type. | | Special focus status | Include or narrow special-focus facility status. | | Minimum/maximum overall rating | Keep facilities within a CMS overall star rating range. | | Minimum/maximum certified beds | Keep facilities within a certified bed range. | | Include raw CMS source row | Attach the original CMS source row in `rawSource`. | | Maximum facilities | Cap the number of successful facility rows saved. | #### ๐Ÿงพ Output example ```json { "ccn": "055010", "facilityName": "MAPLE GROVE CARE CENTER", "legalBusinessName": "Maple Grove Care Center LLC", "providerType": "Medicare and Medicaid", "address": "123 Main Street", "city": "Los Angeles", "county": "Los Angeles", "state": "CA", "zip": "90001", "phone": "555-123-4567", "latitude": 34.0522, "longitude": -118.2437, "ownershipType": "For profit - Corporation", "certifiedBeds": 120, "averageResidents": 97.4, "firstApprovedDate": "1989-06-01", "ratings": { "overall": 4, "healthInspection": 3, "staffing": 4, "quality": 5, "shortStay": 4, "longStay": 5 }, "compliance": { "healthDeficiencies": 6, "infectionCitations": 1, "inspectionScore": 42, "specialFocusStatus": "Not a special focus facility", "abuseIndicator": "No", "sprinklerSystems": "Yes" }, "penalties": { "fineCount": 2, "fineTotal": 12500.5, "paymentDenialCount": 1, "penaltyTotal": 22000 }, "staffing": { "rnHoursPerResidentDay": 0.82, "totalNurseStaffHoursPerResidentDay": 3.9, "rnTurnover": 48.2, "totalNursingStaffTurnover": 52.7 }, "chain": { "id": "C12345", "name": "Example Senior Care Group", "facilityCount": 24 }, "source": { "datasetId": "4pq5-n9py", "url": "https://data.cms.gov/provider-data/dataset/4pq5-n9py", "processingDate": "2026-01-01", "fetchedAt": "2026-07-04T12:00:00.000Z" }, "matchedTarget": "Boston", "rawSource": null } ```` #### ๐Ÿ’ณ Pricing This actor uses pay-per-event pricing. You are charged only for each successful CMS nursing home facility row saved to the default dataset. Empty searches, no-result CCN lookups, setup checks, failed source requests, empty pages, and status-only rows are not described as charged work. #### ๐Ÿ”Œ Integrations https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 Use this actor with Apify integrations, API clients, webhooks, scheduled runs, and dataset exports. Send results to spreadsheets, BI tools, databases, or your own app after each run. #### โ“ FAQ **Can I collect all nursing homes nationwide?**\ Yes. Use the nationwide option and set a maximum facility count if you want to cap the run. **Can I fetch facilities by CCN?**\ Yes. Add one or more CMS Certification Numbers to look up exact facilities. **Does this scrape official CMS data?**\ Yes. The actor is designed for official public CMS Nursing Home Compare / Care Compare facility data and includes source audit fields such as dataset ID, source URL, processing date, and fetch time. **Do I need a CMS API key or CMS login?**\ No. The public product contract does not require user-provided CMS credentials, a CMS account, or a paid API key. **What happens when a search has no matching facilities?**\ Valid no-result inputs should finish gracefully and save no charged facility rows. **Why are some fields null?**\ CMS does not publish every measure for every facility. Null means the value was unavailable or blank in the source data. **Can I get the raw CMS row?**\ Yes. Turn on raw source output to include the original CMS source row in `rawSource` for audit workflows. **Is this an official CMS API?**\ No. This is an Apify actor that exports public CMS facility data into an Apify dataset for automation, exports, schedules, APIs, and webhooks. ### ๐Ÿ“ Changelog - 0.0.1: Initial release. ### ๐Ÿ†˜ Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~cms-nursing-home-compare-scraper/issues) and I'll fix or implement it in less than 24h ๐Ÿซก ### ๐Ÿ”— Other actors - [EU Funding & Tenders Scraper โ†—](https://apify.com/maximedupre/eu-funding-tenders-scraper) - Use it for related home workflows. - [Hospital Price Transparency Scraper โ†—](https://apify.com/maximedupre/hospital-price-transparency-scraper) - Use it for related cms workflows. - [Map Your Show Exhibitor Scraper โ†—](https://apify.com/maximedupre/map-your-show-exhibitor-scraper) - Use it for related home workflows. - [Pinterest Keyword Scraper โ†—](https://apify.com/maximedupre/pinterest-keyword-scraper) - Use it for related home workflows. - [RSS Feed Reader โ†—](https://apify.com/maximedupre/rss-feed-reader) - Use it for related home workflows. **Made with โค๏ธ by Maxime Duprรฉ** # Actor input Schema ## `nationwide` (type: `boolean`): Leave enabled to collect facilities across all available CMS states and territories. Turn it off when you fill another Target section. ## `states` (type: `array`): Enter two-letter state or territory codes to collect facilities from those locations. ## `ccns` (type: `array`): Enter exact CMS Certification Numbers (CCNs) to collect specific nursing homes. ## `searchTerms` (type: `array`): Enter facility names, city names, ZIP codes, or similar search terms to find matching nursing homes. ## `ownershipTypes` (type: `array`): Optional ownership filters, such as for profit, non profit, or government ownership terms. ## `specialFocusStatus` (type: `string`): Choose whether to keep only special-focus facilities, exclude them, or include all facilities. ## `minOverallRating` (type: `integer`): Keep facilities with this CMS overall star rating or higher. ## `maxOverallRating` (type: `integer`): Keep facilities with this CMS overall star rating or lower. ## `minCertifiedBeds` (type: `integer`): Keep facilities with at least this many certified beds. ## `maxCertifiedBeds` (type: `integer`): Keep facilities with no more than this many certified beds. ## `includeRawSource` (type: `boolean`): Attach the original CMS source fields beside the normalized facility data for audit workflows. ## `maxResults` (type: `integer`): Stop after this many successful facility rows. Use a smaller value for quick tests and a larger value for exports. ## Actor input object example ```json { "nationwide": true, "states": [ "CA", "NY", "TX" ], "ccns": [ "055010", "335034" ], "searchTerms": [ "Boston", "90210", "Maple Grove" ], "ownershipTypes": [ "For profit", "Non profit" ], "specialFocusStatus": "any", "includeRawSource": false, "maxResults": 100 } ``` # Actor output Schema ## `results` (type: `string`): View the default dataset rows with CMS nursing home facility data. # 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 = { "states": [ "CA", "NY", "TX" ], "ccns": [ "055010", "335034" ], "searchTerms": [ "Boston", "90210", "Maple Grove" ], "ownershipTypes": [ "For profit", "Non profit" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/cms-nursing-home-compare-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 = { "states": [ "CA", "NY", "TX", ], "ccns": [ "055010", "335034", ], "searchTerms": [ "Boston", "90210", "Maple Grove", ], "ownershipTypes": [ "For profit", "Non profit", ], } # Run the Actor and wait for it to finish run = client.actor("maximedupre/cms-nursing-home-compare-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 '{ "states": [ "CA", "NY", "TX" ], "ccns": [ "055010", "335034" ], "searchTerms": [ "Boston", "90210", "Maple Grove" ], "ownershipTypes": [ "For profit", "Non profit" ] }' | apify call maximedupre/cms-nursing-home-compare-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/cms-nursing-home-compare-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CMS Nursing Home Compare Scraper", "description": "Export official CMS Nursing Home Compare facility data. Get one row per nursing home with CCN, address, ownership, beds, ratings, staffing, penalties, chain details, and source audit fields.", "version": "0.1", "x-build-id": "p9JuhxbMfrcA0qW0A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~cms-nursing-home-compare-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-cms-nursing-home-compare-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~cms-nursing-home-compare-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-cms-nursing-home-compare-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~cms-nursing-home-compare-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-cms-nursing-home-compare-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": { "nationwide": { "title": "Collect nationwide", "type": "boolean", "description": "Leave enabled to collect facilities across all available CMS states and territories. Turn it off when you fill another Target section.", "default": true }, "states": { "title": "States or territories", "type": "array", "description": "Enter two-letter state or territory codes to collect facilities from those locations.", "items": { "type": "string" } }, "ccns": { "title": "CMS certification numbers", "type": "array", "description": "Enter exact CMS Certification Numbers (CCNs) to collect specific nursing homes.", "items": { "type": "string" } }, "searchTerms": { "title": "Facility, city, or ZIP searches", "type": "array", "description": "Enter facility names, city names, ZIP codes, or similar search terms to find matching nursing homes.", "items": { "type": "string" } }, "ownershipTypes": { "title": "Ownership types", "type": "array", "description": "Optional ownership filters, such as for profit, non profit, or government ownership terms.", "items": { "type": "string" } }, "specialFocusStatus": { "title": "Special focus status", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Choose whether to keep only special-focus facilities, exclude them, or include all facilities.", "default": "any" }, "minOverallRating": { "title": "Minimum overall rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep facilities with this CMS overall star rating or higher." }, "maxOverallRating": { "title": "Maximum overall rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep facilities with this CMS overall star rating or lower." }, "minCertifiedBeds": { "title": "Minimum certified beds", "minimum": 0, "type": "integer", "description": "Keep facilities with at least this many certified beds." }, "maxCertifiedBeds": { "title": "Maximum certified beds", "minimum": 0, "type": "integer", "description": "Keep facilities with no more than this many certified beds." }, "includeRawSource": { "title": "Include raw CMS source row", "type": "boolean", "description": "Attach the original CMS source fields beside the normalized facility data for audit workflows.", "default": false }, "maxResults": { "title": "Maximum facilities", "minimum": 1, "maximum": 15000, "type": "integer", "description": "Stop after this many successful facility rows. Use a smaller value for quick tests and a larger value for exports.", "default": 100 } } }, "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 } } } } } } } } } } ```