# Caring — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and compare elder care facilities on Caring.com to find detailed information about assisted living, memory care, nursing homes, and more. Access comprehensive facility listings with ratings, pricing, amenities, and resident reviews to help evaluate senior care options across the US.

**Category:** Healthcare | **Website:** [caring.com/](https://caring.com/) | **Docs:** [parse.bot/marketplace/a2fb3442-1465-4029-983b-7b5eb865b972/caring-com-api](https://parse.bot/marketplace/a2fb3442-1465-4029-983b-7b5eb865b972/caring-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-caring-com-api-a2fb3442/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_facility_detail

Get detailed information for a specific facility including address, description, amenities, reviews, pricing, and capacity. The slug is the full path returned by search_facilities (e.g. /senior-living/california/los-angeles/facility-name-90001). Returns a single facility object with all available profile data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Facility slug path starting with /senior-living/ (e.g. /senior-living/california/los-angeles/example-facility-90001). Obtainable from search_facilities results[*].slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-caring-com-api-a2fb3442/get_facility_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_facility_reviews

Get user reviews for a specific facility. Returns the facility name and all available reviews. Each review includes author name, date, numeric rating, text content, and the reviewer's relationship type. Uses the same slug format as get_facility_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Facility slug path starting with /senior-living/ (e.g. /senior-living/california/los-angeles/example-facility-90001). Obtainable from search_facilities results[*].slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-caring-com-api-a2fb3442/get_facility_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_facilities

Search for elder care facilities by location and care type. Returns a list of facility summaries with names, addresses, ratings, and slugs for detail lookups. Results are scoped to one city within one state. The total count reflects all matching facilities for the location/type combination, not just the returned page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City name as a URL slug (lowercase, hyphens for spaces). |
| `state` | string | No | State name as a URL slug (lowercase, hyphens for spaces). |
| `type` | string | No | Care type slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-caring-com-api-a2fb3442/search_facilities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","state":"<string>","type":"<string>"}'
```