# Caring.com Senior Living Directory Scraper (`crawlerbros/caring-com-senior-living-scraper`) Actor Scrape senior living and senior care facility listings from Caring.com. Browse by city, state, and care type (assisted living, memory care, nursing homes, independent living, CCRC, adult day care, in-home care). Get name, address, rating, price, phone, amenities, and website. - **URL**: https://apify.com/crawlerbros/caring-com-senior-living-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Caring.com Senior Living Directory Scraper Scrape senior living and senior care facility listings from [Caring.com](https://www.caring.com) - the largest online senior care directory in the US. Browse facilities by city, state, and care type (assisted living, memory care, nursing homes, independent living, CCRC, adult day care, in-home care). Get facility name, address, rating, review count, starting price, phone number, amenities, and website - no login, no cookies, no paid proxy required. ### What this actor does - **Browse by location** - pick any US state + city and a care type; the actor geocodes the city and pulls every matching facility within your chosen radius - **7 care types** - Assisted Living, Memory Care, Nursing Homes, Independent Living, Continuing Care Retirement Communities (CCRC), Adult Day Care, In-Home Care - **Direct URL lookup** - pass Caring.com facility detail-page URLs to scrape them individually - **Filters** - minimum rating, price range (USD/month), keyword - **Rich per-facility data** - optionally enriches every result with amenities, website URL, cost breakdown, room types, and capacity from the facility's detail page - **Empty fields are omitted** - no null/blank noise in the output ### Output per facility - `name`, `facilityId`, `legacyId`, `slug` - `careType`, `careTypesOffered[]` - `address`, `street`, `city`, `state`, `county`, `zipCode`, `latitude`, `longitude`, `distanceMiles` (mode=byCity - distance from the searched city center) - `averageRating`, `reviewCount`, `lastReviewSnippet` - `activitiesRating`, `facilitiesRating`, `foodRating`, `staffRating`, `valueRating` (per-category rating breakdown, from the facility's detail page) - `startingPriceUSD`, `minimumCostUSD`, `maximumCostUSD` - `phone`, `websiteUrl` - `description` - `amenities[]`, `roomTypes[]`, `residentCapacity`, `license` - `awards[]` (e.g. `"Caring Stars 2022"`) - `nearbyHospitalName`, `nearbyHospitalDistance` - `images[]` - `isCaringStar`, `isVerified`, `isFeaturedListing`, `hasActivePromotion` - `detailUrl`, `sourceUrl` - `recordType: "facility"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `byCity` | `byCity` (browse) or `byUrl` (direct lookup) | | `careType` | string | `assisted-living` | Care type to browse (mode=byCity) | | `state` | string | `california` | US state (mode=byCity) | | `city` | string | `Los Angeles` | City name (mode=byCity) | | `startUrls` | array | - | Facility detail URLs (mode=byUrl) | | `maxDistanceMiles` | int | `30` | Search radius around the city center (1-100) | | `minRating` | int | - | Only facilities rated at least this many stars (1-5) | | `priceMinUSD` | int | - | Only facilities with disclosed price >= this | | `priceMaxUSD` | int | - | Only facilities with disclosed price <= this | | `keyword` | string | - | Only facilities whose name/description contains this text | | `fetchFacilityDetails` | bool | `true` | Visit each facility's detail page for amenities/website/cost | | `maxItems` | int | `20` | Hard cap on emitted records (1-1000) | #### Example: assisted living in Los Angeles, rated 4+ stars ```json { "mode": "byCity", "careType": "assisted-living", "state": "california", "city": "Los Angeles", "minRating": 4, "maxItems": 50 } ```` #### Example: in-home care agencies near Chicago under $6,000/month ```json { "mode": "byCity", "careType": "in-home-care", "state": "illinois", "city": "Chicago", "priceMaxUSD": 6000, "maxItems": 30 } ``` #### Example: direct facility URL lookup ```json { "mode": "byUrl", "startUrls": [ { "url": "https://www.caring.com/senior-living/california/los-angeles/calligraphy-westwood-village" } ] } ``` ### Use cases - **Family caregivers** - compare assisted living, memory care, and nursing home options in a target city - **Senior placement agencies** - bulk-collect facility contact info and pricing for a service area - **Market research** - analyze pricing, amenities, and rating distribution across markets - **Lead generation** - build a contact list of senior care providers by region and care type - **Competitive analysis** - track a competitor's amenities, pricing tier, and review count over time ### FAQ **What's Caring.com?** The largest online destination for family caregivers to find and evaluate eldercare, with over 500,000 senior living and senior care listings across the US. **How does city search work?** The actor resolves your `city`/`state` to geographic coordinates via the free OpenStreetMap geocoding service, then searches Caring.com's own facility directory within `maxDistanceMiles` of that point. **Why do some facilities have no `averageRating`?** Caring.com only publishes a rating once a facility has at least one review. Facilities with zero reviews omit the rating field rather than showing a misleading `0`. **Why do some facilities have no `startingPriceUSD` or `phone`?** Not every provider discloses pricing or a direct phone number publicly on Caring.com; the field is simply omitted rather than shown as empty. **What's the difference between `startingPriceUSD` and `minimumCostUSD`/`maximumCostUSD`?** `startingPriceUSD` comes from the facility's directory listing. `minimumCostUSD`/`maximumCostUSD` come from the facility's detail page and reflect the full disclosed price range across all care levels/room types offered (only populated when `fetchFacilityDetails` is enabled). **What are `activitiesRating`/`facilitiesRating`/`foodRating`/`staffRating`/`valueRating`?** Caring.com breaks its overall `averageRating` down into five reviewer-scored categories on the facility's detail page. Each is only populated when at least one reviewer scored that category (only populated when `fetchFacilityDetails` is enabled). **What's `nearbyHospitalName`/`nearbyHospitalDistance`?** The closest hospital to the facility, as identified by Caring.com, with its distance (only populated when `fetchFacilityDetails` is enabled). **Does this need a login or proxy?** No. All data comes from Caring.com's public directory pages and JSON search API, plus the free OpenStreetMap geocoding API. No cookies, no paid proxy, no API key. **Is `websiteUrl` always reachable?** `detailUrl`/`sourceUrl` (Caring.com's own pages) and `images[]` (Caring.com's own CDN) are always live. `websiteUrl` is the facility's own independently-operated website, scraped as-is from Caring.com's listing — like any third-party link, it can occasionally be down, DNS-broken, or bot-blocked on the facility's end, outside Caring.com's and this actor's control. **What if my city isn't found?** The actor uses OpenStreetMap to resolve city names, which covers essentially every incorporated US city and town. Double-check spelling, or try the nearest larger city and increase `maxDistanceMiles`. **Why might a niche care type (e.g. CCRC) in a smaller market return fewer results than expected?** Caring.com's own search backend occasionally under-serves very sparse category/location combinations (a handful of facilities) even though its own result-count metadata says more exist. The actor automatically retries with a smaller page size to recover as many as the backend will actually serve; this is an upstream data-availability quirk, not a scraping limitation. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `careType` (type: `string`): Type of senior care facility to browse (mode=byCity). ## `state` (type: `string`): US state to search in (mode=byCity). ## `city` (type: `string`): City name to search in (mode=byCity), e.g. `Los Angeles`. ## `startUrls` (type: `array`): Caring.com facility detail page URLs to scrape directly. ## `maxDistanceMiles` (type: `integer`): Search radius around the city center (mode=byCity). ## `minRating` (type: `integer`): Only include facilities with an average rating of at least this many stars (1-5). Facilities without any reviews are always included. ## `priceMinUSD` (type: `integer`): Only include facilities whose disclosed starting price is at least this amount. Facilities that don't disclose pricing are always included. ## `priceMaxUSD` (type: `integer`): Only include facilities whose disclosed starting price is at most this amount. Facilities that don't disclose pricing are always included. ## `keyword` (type: `string`): Only include facilities whose name or description contains this text (case-insensitive). ## `fetchFacilityDetails` (type: `boolean`): Visit each facility's detail page to enrich records with amenities, website URL, cost breakdown, and capacity. Slower but more complete. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "byCity", "careType": "assisted-living", "state": "california", "city": "Los Angeles", "startUrls": [], "maxDistanceMiles": 30, "fetchFacilityDetails": true, "maxItems": 20 } ``` # Actor output Schema ## `facilities` (type: `string`): Dataset containing all scraped facility 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 = { "mode": "byCity", "careType": "assisted-living", "state": "california", "city": "Los Angeles", "startUrls": [], "maxDistanceMiles": 30, "fetchFacilityDetails": true, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/caring-com-senior-living-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 = { "mode": "byCity", "careType": "assisted-living", "state": "california", "city": "Los Angeles", "startUrls": [], "maxDistanceMiles": 30, "fetchFacilityDetails": True, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/caring-com-senior-living-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 '{ "mode": "byCity", "careType": "assisted-living", "state": "california", "city": "Los Angeles", "startUrls": [], "maxDistanceMiles": 30, "fetchFacilityDetails": true, "maxItems": 20 }' | apify call crawlerbros/caring-com-senior-living-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/caring-com-senior-living-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Caring.com Senior Living Directory Scraper", "description": "Scrape senior living and senior care facility listings from Caring.com. Browse by city, state, and care type (assisted living, memory care, nursing homes, independent living, CCRC, adult day care, in-home care). Get name, address, rating, price, phone, amenities, and website.", "version": "1.0", "x-build-id": "YDuLMdJVQJ2Fp9131" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~caring-com-senior-living-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-caring-com-senior-living-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/crawlerbros~caring-com-senior-living-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-caring-com-senior-living-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/crawlerbros~caring-com-senior-living-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-caring-com-senior-living-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "byCity", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "byCity" }, "careType": { "title": "Care type", "enum": [ "assisted-living", "memory-care-facilities", "nursing-homes", "independent-living", "continuing-care-retirement-communities", "adult-day-care", "in-home-care" ], "type": "string", "description": "Type of senior care facility to browse (mode=byCity).", "default": "assisted-living" }, "state": { "title": "State", "enum": [ "alabama", "alaska", "arizona", "arkansas", "california", "colorado", "connecticut", "delaware", "district-of-columbia", "florida", "georgia", "hawaii", "idaho", "illinois", "indiana", "iowa", "kansas", "kentucky", "louisiana", "maine", "maryland", "massachusetts", "michigan", "minnesota", "mississippi", "missouri", "montana", "nebraska", "nevada", "new-hampshire", "new-jersey", "new-mexico", "new-york", "north-carolina", "north-dakota", "ohio", "oklahoma", "oregon", "pennsylvania", "rhode-island", "south-carolina", "south-dakota", "tennessee", "texas", "utah", "vermont", "virginia", "washington", "west-virginia", "wisconsin", "wyoming" ], "type": "string", "description": "US state to search in (mode=byCity).", "default": "california" }, "city": { "title": "City", "type": "string", "description": "City name to search in (mode=byCity), e.g. `Los Angeles`.", "default": "Los Angeles" }, "startUrls": { "title": "Facility detail URLs (mode=byUrl)", "type": "array", "description": "Caring.com facility detail page URLs to scrape directly.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxDistanceMiles": { "title": "Max distance from city center (miles)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Search radius around the city center (mode=byCity).", "default": 30 }, "minRating": { "title": "Minimum average rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include facilities with an average rating of at least this many stars (1-5). Facilities without any reviews are always included." }, "priceMinUSD": { "title": "Minimum starting price (USD/month)", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Only include facilities whose disclosed starting price is at least this amount. Facilities that don't disclose pricing are always included." }, "priceMaxUSD": { "title": "Maximum starting price (USD/month)", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Only include facilities whose disclosed starting price is at most this amount. Facilities that don't disclose pricing are always included." }, "keyword": { "title": "Keyword filter", "type": "string", "description": "Only include facilities whose name or description contains this text (case-insensitive)." }, "fetchFacilityDetails": { "title": "Fetch amenities & website per facility", "type": "boolean", "description": "Visit each facility's detail page to enrich records with amenities, website URL, cost breakdown, and capacity. Slower but more complete.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } } ```