Lead Generation

Continuing Care Retirement Communities

US continuing care retirement communities (Life Plan communities) and accredited independent living, merged from CMS, CARF and state CCRC registries, with operator, ownership, levels of care and accreditation.

ccrc-communitiesccrclife-plan-communitylead-generationsenior-livingindependent-livingretirement-communitiesusa

1,659 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/ccrc-communities/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 1,659 rows, this download costs 17 credits when the data is fresh enough, or 34 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/ccrc-communities/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "FL",        "PA",        "North Carolina"      ],      "sources": [        "nc-doi",        "ca-cdss",        "carf",        "cms"      ],      "maxItems": 100000,      "carfPrograms": [        "521",        "523"      ]    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

states
string[]
States
Two-letter codes or full names. Empty covers the whole US.
Default
none
Example
FL, PA, North Carolina
sources
enum[]
Sources
Records describing the same campus are merged into one row, with every contributing source listed.
Default
["nc-doi","ca-cdss","carf","cms"]
Allowed values
nc-doi
ca-cdss
carf
cms
maxItems
number
Max communities
Default
100000
Range
1 to 100000

Advanced

carfPrograms
enum[]
CARF programs
CARF program filters to sweep. Only providers holding a CCRC or Independent Senior Living accreditation are kept.
Default
["521","523"]
Allowed values
519
521
523
525
carfRadiusMiles
number
CARF search radius (mi)
CARF answers radius searches only; the US is tiled with overlapping circles of this size.
Default
300
Range
25 to 500
caLicensedOnly
boolean
California: licensed only
Drops pending and closed California facilities.
Default
true
concurrency
number
Concurrent CARF requests
Default
2
Range
1 to 6
requestDelayMs
number
Delay between requests (ms)
Default
300
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "states": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "States",      "description": "Two-letter codes or full names. Empty covers the whole US.",      "default": [],      "examples": [        "FL, PA, North Carolina"      ]    },    "sources": {      "type": "array",      "items": {        "type": "string",        "enum": [          "nc-doi",          "ca-cdss",          "carf",          "cms"        ]      },      "uniqueItems": true,      "title": "Sources",      "description": "Records describing the same campus are merged into one row, with every contributing source listed.",      "default": [        "nc-doi",        "ca-cdss",        "carf",        "cms"      ]    },    "maxItems": {      "type": "number",      "minimum": 1,      "maximum": 100000,      "title": "Max communities",      "default": 100000    },    "carfPrograms": {      "type": "array",      "items": {        "type": "string",        "enum": [          "519",          "521",          "523",          "525"        ]      },      "uniqueItems": true,      "title": "CARF programs",      "description": "CARF program filters to sweep. Only providers holding a CCRC or Independent Senior Living accreditation are kept.",      "default": [        "521",        "523"      ]    },    "carfRadiusMiles": {      "type": "number",      "minimum": 25,      "maximum": 500,      "title": "CARF search radius (mi)",      "description": "CARF answers radius searches only; the US is tiled with overlapping circles of this size.",      "default": 300    },    "caLicensedOnly": {      "type": "boolean",      "title": "California: licensed only",      "description": "Drops pending and closed California facilities.",      "default": true    },    "concurrency": {      "type": "number",      "minimum": 1,      "maximum": 6,      "title": "Concurrent CARF requests",      "default": 2    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 300    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/ccrc-communities/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "FL",        "PA",        "North Carolina"      ],      "sources": [        "nc-doi",        "ca-cdss",        "carf",        "cms"      ],      "maxItems": 100000,      "carfPrograms": [        "521",        "523"      ]    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
accreditations	array	9%
accredited	boolean	100%
alternate_names	array	9%
ca_facility_number	string	6%
capacity	number	6%
carf_programs	array	9%
carf_provider_id	string	9%
ccrc_id	string	100%
certified_beds	number	93%
city	string	100%
cms_ccn	string	93%
cms_overall_rating	number	93%
community_type	string	100%
county	string	96%
latitude	number	100%
legal_entity	string	93%
levels_of_care	array	100%
licensed_by	array	96%
longitude	number	100%
name	string	100%
nc_doi_id	string	3%
nonprofit	boolean	93%
operator	string	100%
ownership_type	string	93%
parent_organization	string	50%
phone	string	100%
source_urls	array	100%
sources	array	100%
state	string	100%
street	string	100%
tax_status	string	93%
website	string	10%
zip	string	100%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
_id	string	100%