CMS Home Health Agencies Scraper (USA)

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

{
  "ccn": "053101",
  "name": "GUARDIAN ANGEL HOME CARE OF SANTA ROSA, LLC",
  "address": "100 STONY POINT ROAD, SUITE 265",
  "city": "SANTA ROSA",
  "state": "CA",
  "zip": "95401",
  "phone": "2482932400",
  "ownershipType": "PROPRIETARY",
  "offersNursingCare": true,
  "offersPhysicalTherapy": true,
  "offersOccupationalTherapy": true,
  "offersSpeechPathology": true,
  "offersMedicalSocial": true,
  "offersHomeHealthAide": false,
  "certificationDate": "2017-04-20",
  "qualityOfCareStarRating": 3,
  "timelyCareStartRate": 64.79,
  "improvedWalkingRate": 90.34,
  "improvedBedTransferRate": 91.41,
  "improvedBathingRate": 89.53,
  "improvedBreathingRate": 97.7,
  "improvedMedicationRate": 91.28,
  "dischargeFunctionScore": 61.22,
  "dischargedToCommunityRate": 71.9,
  "dischargedToCommunityRating": "Same As National Rate",
  "preventableReadmissionRate": 4.14,
  "preventableReadmissionRating": "Same As National Rate",
  "acuteHospitalizationRate": 12.01,
  "acuteHospitalizationRating": "Same As National Rate",
  "medicareSpendingPerEpisode": 0.98,
  "profileUrl": "https://www.medicare.gov/care-compare/details/home-health/053101",
  "aiSummary": "Guardian Angel Home Care of Santa Rosa, LLC is a proprietary home health agency located in Santa Rosa, CA, offering nursing care, physical therapy, occupational therapy, speech pathology, and medical social services. The agency has a quality of care star rating of 3 and demonstrates strong performance in improving patient outcomes, particularly in breathing and mobility.",
  "aiQualitySummary": "Guardian Angel Home Care of Santa Rosa has a moderate care quality star rating of 3, indicating room for improvement. While the agency excels in improvement rates for various functional measures, such as breathing and medication management, it struggles with timely care, achieving only a 64.79% start rate. Additionally, their discharge function score is relatively low at 61.22, suggesting potential challenges in preparing patients for a successful transition home.",
  "aiRisk": ["Quality of care star rating is 3", "Timely care start rate is 64.79, which is below the national average", "Discharge function score is 61.22, indicating potential issues with patient outcomes"],
  "aiRiskLevel": "medium",
  "source": "US CMS Home Health Agencies",
  "observedAt": "2026-08-14T07:11:26.558Z",
  "matchedSearch": null
}

The most complete US home health agency scraper available. It returns every field the CMS Home Health Care Compare dataset exposes for each agency, from ownership and the services offered to the quality-of-patient-care star rating and the full set of outcome measures, plus optional AI summaries, and gives you filters to target exactly the agencies 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 reads the CMS Home Health Agency dataset behind Medicare Care Compare, applies the filters you pass as input, and writes one normalized record per agency to the run's dataset. Each record carries location and contact details, ownership type, the services offered (skilled nursing, physical therapy, occupational therapy, speech pathology, medical social, home health aide), the quality-of-patient-care star rating, and the full set of CMS outcome measures (timely care, functional improvement, discharge to community, preventable readmission, acute hospitalization, Medicare spending). Missing source values are returned as null, never invented.

Three optional paid AI add-ons layer on top: an agency summary, a plain-English quality summary, and quality risk flags for low performers. Each is charged only when it produces usable output.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 3 California home health agencies with AI agency summary, quality summary, and risk flags.

{
  "states": ["CA"],
  "maxAgencies": 3,
  "withAiSummary": true,
  "withAiQualitySummary": true,
  "withAiRisk": true,
  "ownershipType": "",
  "requireNursing": false,
  "requirePhysicalTherapy": false,
  "requireOccupationalTherapy": false,
  "requireSpeechPathology": false,
  "requireMedicalSocial": false,
  "requireHomeHealthAide": false
}

Every input field is optional. Provide agencyNames keywords to search by name, or use states, cities, and zipCodes to restrict geography. Default maxAgencies is 50.

Input reference

Field	Type	Required	Default	Description
agencyNames	string[]	no	["VNA"]	Agency names or keywords to search, one per line, for example VNA, home health.
states	string[]	no	(any)	Two-letter US state codes to restrict results, for example CA, TX, FL.
cities	string[]	no	(any)	City names to restrict results, for example Houston, Miami.
zipCodes	string[]	no	(any)	ZIP codes to restrict results.
ownershipType	enum	no	(any)	Restrict by ownership category. One of PROPRIETARY, VOLUNTARY NON-PROFIT, GOVERNMENT, or empty for any.
requireNursing	boolean	no	false	Only agencies that offer skilled nursing care.
requirePhysicalTherapy	boolean	no	false	Only agencies that offer physical therapy.
requireOccupationalTherapy	boolean	no	false	Only agencies that offer occupational therapy.
requireSpeechPathology	boolean	no	false	Only agencies that offer speech pathology.
requireMedicalSocial	boolean	no	false	Only agencies that offer medical social services.
requireHomeHealthAide	boolean	no	false	Only agencies that offer home health aide services.
minStarRating	integer	no	(any)	Only agencies with at least this quality-of-patient-care star rating (1-5).
maxStarRating	integer	no	(any)	Only agencies with at most this quality-of-patient-care star rating (1-5).
maxAgencies	integer	no	50	Maximum number of agencies to collect across all searches. Free Apify plans are capped at 10.
withAiSummary	boolean	no	false	Paid AI add-on. Concise summary of the agency, ownership, and services. Charged only on usable AI output. Requires a paid Apify plan.
withAiQualitySummary	boolean	no	false	Paid AI add-on. Plain-English summary of care quality from the star rating and measures. Charged only on usable AI output. Requires a paid Apify plan.
withAiRisk	boolean	no	false	Paid AI add-on. Surface quality red flags for low performers. Charged only on usable AI output. Requires a paid Apify plan.

Output reference

One dataset item per agency. Types: string, number, integer, boolean, string[], or null when the source value is absent.

Field	Type	Description
ccn	string	CMS Certification Number (unique per agency).
name	string	Agency name.
address	string	Street address.
city	string	City.
state	string	Two-letter state code.
zip	string	ZIP code.
phone	string	Phone number.
ownershipType	string	Ownership type, for example PROPRIETARY.
offersNursingCare	boolean	Offers skilled nursing.
offersPhysicalTherapy	boolean	Offers physical therapy.
offersOccupationalTherapy	boolean	Offers occupational therapy.
offersSpeechPathology	boolean	Offers speech pathology.
offersMedicalSocial	boolean	Offers medical social services.
offersHomeHealthAide	boolean	Offers home health aide.
certificationDate	string	Medicare certification date (YYYY-MM-DD).
qualityOfCareStarRating	integer	Quality of patient care star rating (1-5), or null.
timelyCareStartRate	number	Percent timely start of care.
improvedWalkingRate	number	Percent of patients who improved walking.
improvedBedTransferRate	number	Percent of patients who improved bed transfer.
improvedBathingRate	number	Percent of patients who improved bathing.
improvedBreathingRate	number	Percent of patients who improved breathing.
improvedMedicationRate	number	Percent of patients who improved taking medication.
dischargeFunctionScore	number	Discharge function score.
dischargedToCommunityRate	number	Risk-standardized discharge-to-community rate.
dischargedToCommunityRating	string	Discharge-to-community performance versus national rate.
preventableReadmissionRate	number	Potentially preventable readmission rate.
preventableReadmissionRating	string	Readmission performance versus national rate.
acuteHospitalizationRate	number	Potentially preventable hospitalization rate.
acuteHospitalizationRating	string	Hospitalization performance versus national rate.
medicareSpendingPerEpisode	number	Medicare spending per episode ratio.
profileUrl	string	Medicare Care Compare profile URL.
aiSummary	string	AI agency summary, or null unless the add-on is enabled.
aiQualitySummary	string	AI quality summary, or null unless the add-on is enabled.
aiRisk	string[]	AI quality red flags, empty array when none, or null unless enabled.
aiRiskLevel	string	AI overall risk level (low, medium, high), or null.
matchedSearch	string	The agencyNames search term that matched this agency, or null.
source	string	Data source. Always US CMS Home Health Agencies.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	Present only on a failed or empty run. A single item with a populated error field is written instead of results, and it is not charged.

Example output record

Real record from a live run (input {"states": ["CA"], "maxAgencies": 3, "withAiSummary": true, "withAiQualitySummary": true, "withAiRisk": true}):

{
  "ccn": "053101",
  "name": "GUARDIAN ANGEL HOME CARE OF SANTA ROSA, LLC",
  "address": "100 STONY POINT ROAD, SUITE 265",
  "city": "SANTA ROSA",
  "state": "CA",
  "zip": "95401",
  "phone": "2482932400",
  "ownershipType": "PROPRIETARY",
  "offersNursingCare": true,
  "offersPhysicalTherapy": true,
  "offersOccupationalTherapy": true,
  "offersSpeechPathology": true,
  "offersMedicalSocial": true,
  "offersHomeHealthAide": false,
  "certificationDate": "2017-04-20",
  "qualityOfCareStarRating": 3,
  "timelyCareStartRate": 64.79,
  "improvedWalkingRate": 90.34,
  "improvedBedTransferRate": 91.41,
  "improvedBathingRate": 89.53,
  "improvedBreathingRate": 97.7,
  "improvedMedicationRate": 91.28,
  "dischargeFunctionScore": 61.22,
  "dischargedToCommunityRate": 71.9,
  "dischargedToCommunityRating": "Same As National Rate",
  "preventableReadmissionRate": 4.14,
  "preventableReadmissionRating": "Same As National Rate",
  "acuteHospitalizationRate": 12.01,
  "acuteHospitalizationRating": "Same As National Rate",
  "medicareSpendingPerEpisode": 0.98,
  "profileUrl": "https://www.medicare.gov/care-compare/details/home-health/053101",
  "aiSummary": "Guardian Angel Home Care of Santa Rosa, LLC is a proprietary home health agency located in Santa Rosa, CA, offering nursing care, physical therapy, occupational therapy, speech pathology, and medical social services. The agency has a quality of care star rating of 3 and demonstrates strong performance in improving patient outcomes, particularly in breathing and mobility.",
  "aiQualitySummary": "Guardian Angel Home Care of Santa Rosa has a moderate care quality star rating of 3, indicating room for improvement. While the agency excels in improvement rates for various functional measures, such as breathing and medication management, it struggles with timely care, achieving only a 64.79% start rate. Additionally, their discharge function score is relatively low at 61.22, suggesting potential challenges in preparing patients for a successful transition home.",
  "aiRisk": ["Quality of care star rating is 3", "Timely care start rate is 64.79, which is below the national average", "Discharge function score is 61.22, indicating potential issues with patient outcomes"],
  "aiRiskLevel": "medium",
  "source": "US CMS Home Health Agencies",
  "observedAt": "2026-08-14T07:11:26.558Z",
  "matchedSearch": 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~cms-home-health-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"states":["TX"],"minStarRating":4,"requireNursing":true,"maxAgencies":50}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~cms-home-health-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"agencyNames":["VNA"],"states":["NY"],"maxAgencies":100}'

Apify CLI:

apify call scrapers_lat/cms-home-health-scraper \
  --input '{"states":["CA"],"maxAgencies":10}'

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 agency record returned (result event). See the pricing tab for the current per-result price.
• Paid AI add-ons. ai_summary, ai_quality_summary, and ai_risk are separate events, each billed only when they produce usable output. Leave them off to pay for results only.
• No charge on failure. If a run errors or finds nothing, 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 maxAgencies.

FAQ and troubleshooting

A run returned 0 records. Why? The search terms and filters matched nothing. Broaden agencyNames, remove a geographic filter, or lower minStarRating. Zero-result runs are not charged.

How do I search by agency name? Put one or more keywords in agencyNames (for example VNA or home health). The term that matched appears in matchedSearch on each record.

How do I get only high-quality agencies? Set minStarRating to 4 or 5. Combine with requireNursing or other service flags.

Why is a measure null? CMS suppresses or does not report some measures for smaller agencies. Missing source values are returned as null, never invented.

Do the AI add-ons need a paid plan? Yes. The AI summary, quality summary, and risk add-ons require a paid Apify plan and are charged only when they return usable output.

Is this an official Medicare or CMS tool? No. This actor is independent and has no affiliation with CMS or Medicare. It reads only data that is publicly available through Medicare Care Compare.

Related scrapers

• US Dialysis Facilities Scraper: CMS dialysis facility chain, rating, and quality.
• US Nursing Homes Scraper: CMS nursing home ratings, staffing, and inspections.
• US Hospitals Scraper: CMS hospital ratings and quality measures.
• CMS Open Payments Scraper: industry payments to physicians and teaching hospitals.

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 CMS or Medicare. Accesses only publicly available Medicare Care Compare data.