recovery.com APIrecovery.com ↗
Access recovery center listings, location data, and facility details from Recovery.com via 3 endpoints. Filter by condition, insurance, and location.
curl -X GET 'https://api.parse.bot/scraper/86dc8dde-6b34-4095-85c7-6758917309f1/search_centers?page=0&limit=5&query=recovery&location=Austin' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for recovery centers with optional filters for location, condition, and insurance. Returns paginated results from the recovery.com index.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (0-indexed). |
| limit | integer | Number of results per page. |
| query | string | Search keyword (center name or general term). |
| location | string | Filter by location as listed in get_locations_list (e.g. 'Texas', 'Austin', 'California'). |
| condition | string | Filter by condition treated (e.g. 'Drug Addiction', 'Alcohol', 'Cocaine', 'Opioids'). |
| insurance | string | Filter by accepted insurance provider (e.g. 'Aetna', 'Cigna', 'BlueCross BlueShield'). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"limit": "integer, results per page",
"centers": "array of center summary objects with name, slug, location, address, rating, review_count, price_label, short_description, thumbnail, and verified fields"
},
"sample": {
"data": {
"page": 0,
"limit": 5,
"centers": [
{
"name": "Infinite Recovery - Austin",
"slug": "infinite-recovery-texas",
"rating": 4.52,
"address": "123 Main St, Springfield, IL 62704",
"location": "Austin, Texas, United States",
"verified": true,
"thumbnail": "https://res.cloudinary.com/rehabpath/image/upload/v1733406757/j4c1dann0ccfwsorgzlu.jpg",
"price_label": "$23,000 - $99,350",
"review_count": 122,
"short_description": "Helps clients create a life free from destructive behaviors..."
}
]
},
"status": "success"
}
}About the recovery.com API
The Recovery.com API gives developers structured access to addiction and mental health treatment center data across the United States through 3 endpoints. Use search_centers to query the Recovery.com index by location, condition, or insurance provider and receive paginated summaries including ratings, pricing labels, and addresses. Use get_center_detail to pull full facility records including amenities, insurance acceptance, contact info, and FAQ entries for any specific center.
Searching for Recovery Centers
The search_centers endpoint accepts optional filters for location (state, city, or region name as returned by get_locations_list), condition (e.g. 'Drug Addiction', 'Opioids', 'Cocaine'), and insurance (e.g. 'Aetna', 'Cigna', 'BlueCross BlueShield'). You can also pass a freeform query string to match against center names or general terms. Results are paginated via page (0-indexed) and limit. Each item in the centers array includes the center's name, slug, address, rating, review_count, price_label, short_description, and a thumbnail URL.
Facility Detail
Passing a center's slug to get_center_detail returns a deeper record. The response includes contact (phone number and website), filters (primary focus and treatment setting), ratings (numeric rating and review count), Amenities (array of strings), insurance (accepted flag, list of provider names, and the facility's provider policy), price (duration and price strings), and a video embed URL if the facility has one. An faq array contains any FAQ entries the facility has published. The city and state fields identify the facility's location.
Location Browsing
The get_locations_list endpoint returns the full list of US states, cities, and regions that have at least one listed recovery center. Each entry carries a name and a count of listed facilities. This endpoint is the correct source for valid location values to pass to search_centers — using a name not in this list may return empty results.
Data Scope and Pagination
Coverage is limited to facilities listed on Recovery.com in the United States. Pagination in search_centers is 0-indexed, so the first page is page=0. The slug field returned in search results is the required identifier for get_center_detail; no other ID format is accepted.
- Build a treatment center finder that filters results by insurance provider and condition type
- Aggregate facility amenities and pricing labels across multiple centers for comparison tools
- Map recovery center locations by state or city using the counts from get_locations_list
- Display facility contact information and video embeds in a healthcare directory app
- Enrich a CRM with insurance acceptance details pulled from get_center_detail
- Monitor rating and review counts across a set of facilities over time using their slugs
- Power a referral tool that matches patients to centers by condition and geographic region
| 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 | 250 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.