Lead Generation

US Assisted Living Facilities (State Licensing Rosters)

Licensed assisted living, residential care and adult family care facilities from US state licensing agencies — facility name, type, license number and status, licensee/operator, administrator where published, address, county, phone, capacity and coordinates.

state-assisted-livinglead-generationsenior-livingassisted-livinghealthcareusapublic-record

31,654 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/state-assisted-living/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 31,654 rows, this download costs 317 credits when the data is fresh enough, or 634 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/state-assisted-living/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "FL"      ],      "includeInactive": false,      "maxItems": 250000,      "requestDelayMs": 250    }  }'

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
enum[]
States
Empty means every supported state. Each state is read from its own licensing agency roster.
Default
none
Allowed values
FL
CA
TX
AZ
NC
PA
NY
OH
MI
WA
MO
MD
includeInactive
boolean
Include closed facilities
Rosters that publish closed or inactive licenses (California) keep them only when this is on.
Default
false

Advanced

maxItems
number
Max facilities per run
Default
250000
Range
1 to 250000
requestDelayMs
number
Delay between pages (ms)
Default
250
Range
0 to 30000

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",        "enum": [          "FL",          "CA",          "TX",          "AZ",          "NC",          "PA",          "NY",          "OH",          "MI",          "WA",          "MO",          "MD"        ]      },      "uniqueItems": true,      "title": "States",      "description": "Empty means every supported state. Each state is read from its own licensing agency roster.",      "default": []    },    "includeInactive": {      "type": "boolean",      "title": "Include closed facilities",      "description": "Rosters that publish closed or inactive licenses (California) keep them only when this is on.",      "default": false    },    "maxItems": {      "type": "number",      "minimum": 1,      "maximum": 250000,      "title": "Max facilities per run",      "default": 250000    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between pages (ms)",      "default": 250    }  }}

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/state-assisted-living/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "FL"      ],      "includeInactive": false,      "maxItems": 250000,      "requestDelayMs": 250    }  }' | 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
address	string	100%
administrator_name	string	99%
capacity	number	100%
city	string	100%
county	string	100%
facility_key	string	100%
facility_name	string	100%
facility_subtype	string	100%
facility_type	string	100%
latitude	number	91%
license_effective_date	date	91%
license_number	string	100%
license_status	string	100%
licensee_name	string	100%
longitude	number	91%
phone	string	100%
source_agency	string	100%
source_id	string	100%
state	string	100%
zip	string	100%
created_at	date	100%
scraped_at	date	100%
updated_at	date	100%
_id	string	100%