SeniorAdvisor APIsenioradvisor.com ↗
Search and retrieve senior care facility data from SeniorAdvisor.com. Access pricing, ratings, services, reviews, and care types via 5 structured endpoints.
What is the SeniorAdvisor API?
The SeniorAdvisor.com API provides access to senior care facility data across the US through 5 endpoints, covering facility search, detailed profiles, location autocomplete, care type listings, and state-level browsing. The get_facility_detail endpoint returns over 8 structured fields per facility including pricing by room type, services, photos, and contact information, making it practical for building care-finder tools or populating comparison databases.
curl -X GET 'https://api.parse.bot/scraper/5e712659-d268-4efd-b3c4-226929bf76d4/search_facilities?page=1&care_type=assisted-living&location_slug=new-york-ny' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace senioradvisor-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.senioradvisor_api import SeniorAdvisor, CareType, FacilitySummary, Facility, CareTypeOption, State, Location
client = SeniorAdvisor()
# Search for locations by city name
for location in client.locations.search(term="New York"):
print(location.label, location.to_url)
# List available care types
for care_type_option in client.caretypeoptions.list():
print(care_type_option.name, care_type_option.slug)
# Search facilities using a care type enum
for facility_summary in client.facilitysummaries.search(location_slug="new-york-ny", care_type=CareType.MEMORY_CARE):
print(facility_summary.name, facility_summary.address, facility_summary.rating)
# Get full details for a specific facility
facility = client.facilities.get(slug="atria-west-86-new-york-ny")
print(facility.name, facility.address, facility.phone, facility.rating)
for pricing in facility.pricing:
print(pricing.room_type, pricing.price)
# Navigate from summary to detail
for summary in client.facilitysummaries.search(location_slug="new-york-ny", care_type=CareType.ASSISTED_LIVING, limit=2):
detail = summary.details()
print(detail.name, detail.description, detail.review_count)
# List states for hierarchical browsing
for state in client.states.list():
print(state.name, state.url, state.slug)
Search for senior care facilities by location and care type. Returns a paginated list of facility summaries including name, slug, address, rating, and review count. Location can be a city-state slug (from search_location's to_url) or a ZIP code. Paginates via integer page number.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| care_type | string | Care type slug. |
| location_slugrequired | string | Location slug (e.g. 'new-york-ny') or ZIP code (e.g. '10001'). Obtain slugs from search_location endpoint's to_url field. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"results": "array of facility summaries with name, slug, address, rating, review_count, url",
"location": "string - the location_slug that was searched",
"care_type": "string - the care type slug used"
},
"sample": {
"data": {
"page": 1,
"results": [
{
"url": "https://www.senioradvisor.com/local/atria-west-86-new-york-ny",
"name": "Atria West 86 - New York, NY",
"slug": "atria-west-86-new-york-ny",
"rating": 4.5,
"address": "333 W 86th St, New York, NY 10024",
"review_count": 148
}
],
"location": "new-york-ny",
"care_type": "assisted-living"
},
"status": "success"
}
}About the SeniorAdvisor API
Searching Facilities
The search_facilities endpoint accepts a location_slug (e.g., new-york-ny) or ZIP code and an optional care_type slug to return paginated facility summaries. Each result includes the facility's name, slug, address, rating, review_count, and url. The care_type parameter accepts values such as assisted-living, memory-care, nursing-home, independent-living, and senior-apartm. Use search_location to resolve a city name or ZIP code to a valid to_url slug before querying.
Facility Detail
Passing a facility slug from search results to get_facility_detail returns the full profile: address, phone, rating, review_count, description, photos (array of URLs), services (array of amenity/service strings), and pricing (array of objects with room_type and price). The endpoint also returns a nearby_facilities array with names and URLs, which supports geographic discovery without additional geocoding.
Location and Category Discovery
search_location functions as an autocomplete resolver — pass a partial city name or ZIP and it returns matching entries with label, id, and a to_url field ready for use in search_facilities. list_care_types returns all supported care categories with their slug and name, so you can enumerate valid care_type values without hardcoding them. search_by_state lists all US states and Canadian provinces with their facility-browsing url, name, and slug, enabling hierarchical drill-down from state to city to individual facility.
The SeniorAdvisor API is a managed, monitored endpoint for senioradvisor.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when senioradvisor.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official senioradvisor.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a senior care comparison tool that surfaces pricing by room type and ratings from
get_facility_detail - Populate a directory of assisted-living or memory-care facilities filtered by city using
search_facilities - Generate state-level landing pages for senior care resources using slugs from
search_by_state - Aggregate review counts and average ratings across facilities in a ZIP code for market research
- Resolve user-typed city names to valid location slugs with
search_locationbefore running facility searches - Extract services and amenities arrays from
get_facility_detailto power structured facility filtering - Map nearby facility networks from the
nearby_facilitiesfield in facility detail responses
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SeniorAdvisor.com have an official developer API?+
What does the `get_facility_detail` endpoint return for pricing?+
pricing field is an array of objects, each with a room_type and a price value. This reflects the room-level pricing displayed on individual facility pages. Prices are returned as listed on the source and are not normalized to a consistent format.Does the API return individual user reviews and review text?+
rating and review_count per facility but does not expose individual review content or reviewer details. You can fork this API on Parse and revise it to add an endpoint that fetches per-review data.How does pagination work in `search_facilities`?+
search_facilities endpoint accepts an integer page parameter. The response includes the current page number alongside the results array. There is no explicit total_pages or total_results field in the response, so you iterate pages until the results array is empty or returns fewer items than a full page.Does the API cover Canadian senior care facilities?+
search_by_state endpoint does include Canadian provinces in its results, but facility density and data completeness outside the US may be limited. You can fork this API on Parse and revise it to scope searches specifically to Canadian provinces using the province slugs returned by that endpoint.