55+ Active Adult Communities
Every 55+ active adult community listed on 55places.com, with address, builder, home count, age restriction, gating, amenities, clubs and price range.
3,485 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/active-adult-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.csvAt its current 3,485 rows, this download costs 35 credits when the data is fresh enough, or 70 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/active-adult-communities/runs" \ -H "Authorization: Bearer $PANDORLABS_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "states": [ "FL", "AZ", "California" ], "ageRestrictedOnly": false, "includeRentals": true, "maxItems": 100000 } }'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
statesstring[]
States
Two-letter codes or full names. Empty sweeps every state 55places lists.
- Default
- none
- Example
FL, AZ, California
ageRestrictedOnlyboolean
Age-restricted (55+) only
55places also lists active-adult communities with no formal age restriction.
- Default
false
includeRentalsboolean
Include rental communities
- Default
true
maxItemsnumber
Max communities
- Default
100000- Range
- 1 to 100000
Advanced
includeFullDescriptionboolean
Keep the full description
The long editorial text, a few KB per community. The short summary is always kept.
- Default
true
hitsPerPagenumber
Communities per request
- Default
1000- Range
- 1 to 1000
requestDelayMsnumber
Delay between requests (ms)
- Default
500- Range
- 0 to 60000
algoliaAppIdstring
Algolia app id
Published in the 55places page source. Rediscovered automatically if the configured key is rejected.
- Default
A5SC4TBLCP
algoliaApiKeystring
Algolia search key
- Default
5172c8507603567860ad6c295c1c9226
indexNamestring
Algolia index
- Default
alex_communities
Input as JSON Schema
The same schema the API validates against. Use it as a tool input schema or to generate a typed client.
{ "type": "object", "additionalProperties": false, "properties": { "states": { "type": "array", "items": { "type": "string" }, "maxItems": 1000, "title": "States", "description": "Two-letter codes or full names. Empty sweeps every state 55places lists.", "default": [], "examples": [ "FL, AZ, California" ] }, "ageRestrictedOnly": { "type": "boolean", "title": "Age-restricted (55+) only", "description": "55places also lists active-adult communities with no formal age restriction.", "default": false }, "includeRentals": { "type": "boolean", "title": "Include rental communities", "default": true }, "maxItems": { "type": "number", "minimum": 1, "maximum": 100000, "title": "Max communities", "default": 100000 }, "includeFullDescription": { "type": "boolean", "title": "Keep the full description", "description": "The long editorial text, a few KB per community. The short summary is always kept.", "default": true }, "hitsPerPage": { "type": "number", "minimum": 1, "maximum": 1000, "title": "Communities per request", "default": 1000 }, "requestDelayMs": { "type": "number", "minimum": 0, "maximum": 60000, "title": "Delay between requests (ms)", "default": 500 }, "algoliaAppId": { "type": "string", "maxLength": 2000, "title": "Algolia app id", "description": "Published in the 55places page source. Rediscovered automatically if the configured key is rejected.", "default": "A5SC4TBLCP" }, "algoliaApiKey": { "type": "string", "maxLength": 2000, "title": "Algolia search key", "default": "5172c8507603567860ad6c295c1c9226" }, "indexName": { "type": "string", "maxLength": 2000, "title": "Algolia index", "default": "alex_communities" } }}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/active-adult-communities/runs" \ -H "Authorization: Bearer $PANDORLABS_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "states": [ "FL", "AZ", "California" ], "ageRestrictedOnly": false, "includeRentals": true, "maxItems": 100000 } }' | 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 |
|---|---|---|
| age_restricted | boolean | 100% |
| age_restriction | string | 100% |
| amenities | array | 98% |
| amenities_count | number | 98% |
| builder | string | 40% |
| builder_source | string | 40% |
| city | string | 100% |
| climate | string | 100% |
| clubs | array | 80% |
| clubs_count | number | 80% |
| community_category | string | 100% |
| community_id | string | 100% |
| description | string | 100% |
| description_full | string | 100% |
| has_activity_director | boolean | 100% |
| home_types | array | 100% |
| is_gated | boolean | 100% |
| is_pet_friendly | boolean | 100% |
| latitude | number | 99% |
| listing_count | number | 100% |
| longitude | number | 99% |
| name | string | 100% |
| near | array | 27% |
| new_or_resale | string | 98% |
| phone | string | 100% |
| photo_url | string | 93% |
| price_max | number | 76% |
| price_min | number | 76% |
| price_range | string | 99% |
| price_range_high | string | 96% |
| price_range_low | string | 99% |
| rating | number | 21% |
| review_count | number | 100% |
| state | string | 100% |
| state_name | string | 100% |
| street | string | 100% |
| total_homes | number | 98% |
| year_built_end | number | 63% |
| year_built_start | number | 98% |
| zip | string | 100% |
| created_at | date | 100% |
| first_seen_at | date | 100% |
| last_seen_at | date | 100% |
| updated_at | date | 100% |
| _id | string | 100% |
