# Medicare Home Health Compare Scraper | Agency Ratings (`parseforge/home-health-compare-scraper`) Actor
Export Medicare Home Health agencies: name, address, ownership, services offered, quality measures and star ratings. Filter by state, city or ownership type. Power healthcare lead generation, provider selection and competitive analysis. CSV, Excel, JSON or XML.
- **URL**: https://apify.com/parseforge/home-health-compare-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Other, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $19.00 / 1,000 results
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
## ๐ Medicare Home Health Compare Scraper
> ๐ **Export every Medicare-certified home health agency in seconds.** Pull star ratings, services offered, ownership, certification dates, and locations from CMS Care Compare. Download as CSV, Excel, JSON, or XML.
> ๐ **Last updated:** 2026-05-25 ยท **๐ 30+ fields** per record ยท 11,000+ agencies ยท United States
The **Medicare Home Health Compare Scraper** queries the official CMS Provider Data API powering medicare.gov/care-compare for home health. Every record contains the agency's CMS certification number (CCN), provider name, address, type of ownership, certification date, services offered (nursing, physical therapy, occupational therapy, speech, medical social, home health aide), quality of patient care star rating, and the published numerator/denominator measures.
**Coverage:** every Medicare-certified home health agency in the United States.
---
### Target Audience / Use Cases
| ๐ฏ Target Audience | ๐ก Primary Use Cases |
|---|---|
| Health plans | Network adequacy and quality scoring |
| Hospital discharge planners | Find agencies by service mix |
| M&A / private equity | Map the home health landscape |
| Researchers | Quality and ownership analyses |
| Journalists | Investigate ownership trends |
| Healthtech vendors | Seed agency directories |
---
### ๐ What this scraper does
- Pulls the full Home Health Agency dataset
- Filters by state, city, ownership type
- Returns CCN, services offered booleans, quality star rating
- Includes patient-care measure numerators / denominators
- Outputs JSON, CSV, Excel, XML
---
### ๐ฌ Full Demo
_๐ง Coming soon_
---
### โ๏ธ Input
| Field | Type | Required | Default | Description |
|---|
maxItems | integer | No | 10 | Max records. |
state | string | No | | Two-letter U.S. state. |
cityTown | string | No | | Exact city match. |
typeOfOwnership | select | No | Any | Ownership type. |
**Example 1 - All Alaska agencies:**
```json
{ "state": "AK", "maxItems": 50 }
````
**Example 2 - Proprietary agencies in Texas:**
```json
{ "state": "TX", "typeOfOwnership": "PROPRIETARY", "maxItems": 300 }
```
> โ ๏ธ **Good to Know:** Some agencies report `-` for ratings when they have insufficient data. The actor preserves these raw values.
***
### ๐ Output
Sample:
```json
{
"cms_certification_number_ccn": "027001",
"provider_name": "PROVIDENCE AT HOME WITH COMPASSUS HH ANCHORAGE",
"address": "4001 DALE STREET, SUITE 101",
"citytown": "ANCHORAGE",
"state": "AK",
"type_of_ownership": "PROPRIETARY",
"offers_nursing_care_services": "Yes",
"offers_physical_therapy_services": "Yes",
"quality_of_patient_care_star_rating": "4",
"certification_date": "05/17/1982"
}
```
Key fields: CCN, provider\_name, address, citytown, state, zip\_code, telephone\_number, type\_of\_ownership, certification\_date, offers\_\*, quality\_of\_patient\_care\_star\_rating, plus all OASIS quality measure numerators/denominators.
***
### โจ Why choose this Actor
- ๐ข Backed by official CMS Provider Data
- ๐ข No registration, no API key
- ๐ข Filter combinations supported
- ๐ข Up to 1,000,000 records per paid run
***
### ๐ How it compares to alternatives
| Option | Free | Bulk export | Live |
|---|---|---|---|
| medicare.gov Care Compare | Yes | No | Yes |
| Raw CSV downloads | Yes | Yes | Periodic |
| **ParseForge Home Health Scraper** | **Yes** | **Yes** | **Live** |
***
### ๐ How to use
1. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp)
2. Open this actor
3. Set filters, click Start
4. Download CSV / Excel / JSON / XML
5. Schedule or integrate
***
### ๐ผ Business use cases
#### Network composition
Find every Medicare-certified agency in a service area.
#### Service mix analysis
Pivot agencies by offered services.
#### Quality reporting
Reuse star ratings in dashboards.
#### Discharge planning
Generate ranked lists by service availability.
***
### ๐ Automating Home Health Compare Scraper
Integrates with **Make**, **Zapier**, **n8n**, **Slack**, **Airbyte**, **GitHub Actions**, **Google Drive**.
***
### ๐ Beyond business use cases
#### Research
Study home-health ownership and quality correlations.
#### Personal
Locate a certified agency.
#### Non-profit
Quality-monitoring advocacy.
#### Experimentation
Pair with Hospital Compare for full-continuum studies.
***
### ๐ค Ask an AI assistant about this scraper
ChatGPT ยท Claude ยท Perplexity ยท Microsoft Copilot
***
### โ Frequently Asked Questions
**Q: Source?**
CMS Provider Data API.
**Q: API key?**
No.
**Q: Real-time?**
Yes.
**Q: How often is the source updated?**
CMS refreshes regularly.
**Q: Output formats?**
JSON, CSV, Excel, XML.
**Q: Free preview?**
Yes, 10 records.
**Q: Bulk size?**
Up to 1,000,000 paid.
**Q: Coverage?**
All 50 states + DC + territories.
**Q: Ownership types?**
Proprietary, Non-profit (various), Government (Local/State/Federal).
**Q: Quality measures?**
Star rating + per-measure numerators and denominators included.
***
### ๐ Integrate with any app
Webhooks, REST API, Make, Zapier, Slack, Airbyte, Google Sheets, and more.
***
### ๐ Recommended Actors
| Actor | What it does |
|---|---|
| [Medicare Hospital Compare Scraper](https://apify.com/parseforge/hospital-compare-medicare-scraper) | Hospital quality ratings |
| [ICD-10 Codes Scraper](https://apify.com/parseforge/icd10-codes-scraper) | Clinical code reference |
| [Health Canada Drugs Scraper](https://apify.com/parseforge/health-canada-drug-database-scraper) | Canadian drug product DB |
> ๐ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge).
**๐ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA)
> **โ ๏ธ Disclaimer:** independent tool, not affiliated with the Centers for Medicare & Medicaid Services. Only publicly available data from data.cms.gov is collected.
# Actor input Schema
## `maxItems` (type: `integer`):
Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000
## `state` (type: `string`):
Two-letter U.S. state code.
## `cityTown` (type: `string`):
City filter (exact match).
## `typeOfOwnership` (type: `string`):
Filter by ownership type.
## Actor input object example
```json
{
"maxItems": 10
}
```
# Actor output Schema
## `results` (type: `string`):
Scraped Medicare Home Health Compare Scraper - Quality & Services records
# 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 = {
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/home-health-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 = { "maxItems": 10 }
# Run the Actor and wait for it to finish
run = client.actor("parseforge/home-health-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 '{
"maxItems": 10
}' |
apify call parseforge/home-health-compare-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parseforge/home-health-compare-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Medicare Home Health Compare Scraper | Agency Ratings",
"description": "Export Medicare Home Health agencies: name, address, ownership, services offered, quality measures and star ratings. Filter by state, city or ownership type. Power healthcare lead generation, provider selection and competitive analysis. CSV, Excel, JSON or XML.",
"version": "0.1",
"x-build-id": "dyUNtWHO5TFWlVuAm"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parseforge~home-health-compare-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parseforge-home-health-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/parseforge~home-health-compare-scraper/runs": {
"post": {
"operationId": "runs-sync-parseforge-home-health-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/parseforge~home-health-compare-scraper/run-sync": {
"post": {
"operationId": "run-sync-parseforge-home-health-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": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
},
"state": {
"title": "State",
"type": "string",
"description": "Two-letter U.S. state code."
},
"cityTown": {
"title": "City",
"type": "string",
"description": "City filter (exact match)."
},
"typeOfOwnership": {
"title": "Ownership",
"enum": [
"",
"PROPRIETARY",
"NON - PROFIT - OTHER",
"GOVERNMENT - LOCAL",
"GOVERNMENT - STATE/COUNTY",
"GOVERNMENT - FEDERAL",
"NON - PROFIT - PRIVATE",
"NON - PROFIT - CHURCH RELATED",
"PROPRIETARY - INDIVIDUAL",
"PROPRIETARY - CORPORATION",
"PROPRIETARY - PARTNERSHIP"
],
"type": "string",
"description": "Filter by ownership type."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```