ehlers-danlos.com APIehlers-danlos.com ↗
Search EDS healthcare professionals and support groups by location, specialty, profession, and language. Access provider profiles with contact details and credentials.
curl -X GET 'https://api.parse.bot/scraper/4dd4b824-2cc6-4002-ad7e-030e15e773e9/search_providers?page=1&state=CA+-+California&country=United+States' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for healthcare professionals in the directory with optional filters. Returns paginated results sorted by last updated.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| state | string | State/Region value in format 'CODE - Name' (e.g. 'CA - California', 'ON - Ontario'). Use get_directory_filters to retrieve valid values. |
| address | string | Location search string (city, state, or zip code with country) |
| country | string | Country name to filter by (e.g. 'United States', 'Canada', 'Australia'). Use get_directory_filters to retrieve valid values. |
| filters | string | Comma-separated program flags (e.g. 'ECHO Participant,CNE Member'). Use get_directory_filters to retrieve valid values. |
| languages | string | Comma-separated language names to filter by (e.g. 'English,Spanish'). Use get_directory_filters to retrieve valid values. |
| professions | string | Comma-separated profession names to filter by (e.g. 'Physical Therapist/Physiotherapist,Chiropractor'). Use get_directory_filters to retrieve valid values. |
| specialties | string | Comma-separated specialty names to filter by (e.g. 'Genetics,Pain Medicine'). Use get_directory_filters to retrieve valid values. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"providers": "array of provider summary objects with name, slug, profession, specialties, location, phone, email, website",
"total_pages": "integer, total number of pages available"
},
"sample": {
"data": {
"page": 1,
"providers": [
{
"name": "John Doe, PT, DPT",
"slug": "sarah-kretman",
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"website": "https://www.movementmattershealth.com/",
"location": "Prior Lake, MN, United States",
"profession": "Physical Therapist/Physiotherapist",
"specialties": "Exercise/Movement, Physical Therapy/Physiotherapy, Rehabilitation, Neurology"
}
],
"total_pages": 100
},
"status": "success"
}
}About the ehlers-danlos.com API
This API exposes 5 endpoints covering the Ehlers-Danlos Society's healthcare professional directory and support group listings. Using search_providers, you can filter across countries, states, specialties, professions, and languages to retrieve paginated provider summaries including name, slug, profession, specialties, location, phone, email, and website. A companion endpoint, get_provider_detail, returns full profiles with credentials, about text, program certifications, and geocoded practice locations.
Provider Search and Filtering
The search_providers endpoint accepts a range of optional parameters to narrow results: state (in CODE - Name format such as CA - California), address (city, state, or zip with country), country, professions, specialties, languages, and filters for program flags like ECHO Participant or CNE Member. Results are paginated — the response includes page, total_pages, and a providers array. Before constructing filter strings, call get_directory_filters to retrieve the exact label/value pairs available for each dimension: countries, states, specialties, professions, languages, and program flags.
Provider Profiles
get_provider_detail takes a slug from search results and returns a full profile: name (with credentials), about text, email, phone, address (including practice name), website, profession, designation, a programs array of certification labels, and a locations array with latitude, longitude, and address for each practice site. The locations field makes it straightforward to plot providers on a map.
Support Groups and Bulk Retrieval
The get_support_groups endpoint searches EDS/HSD local support groups and charities, filterable by state, country, keyword, and listing_type. Each group object in the response includes name, slug, location, phone, email, and website. For bulk use cases, get_all_providers iterates through multiple directory pages up to a configurable max_pages limit and returns a flat array of all provider summaries, suitable for building a local index or offline dataset.
- Build a map of EDS-aware healthcare providers filtered by specialty such as Genetics or Pain Medicine
- Find physical therapists who speak Spanish within a specific state or country
- List all ECHO Participants or CNE Members using the program_flags filter from get_directory_filters
- Compile a contact list of EDS support groups in Canada using get_support_groups with country filter
- Bulk-export the full provider directory for offline analysis using get_all_providers with max_pages
- Display a provider's geocoded practice locations alongside credentials and about text in a clinic finder app
- Populate a specialty filter dropdown by calling get_directory_filters to retrieve current specialty values
| 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.
Does the Ehlers-Danlos Society offer an official developer API?+
What does get_directory_filters return and why should I call it first?+
languages, professions, specialties, search_state, program_flags, and search_country — each as label/value pairs. The filter parameters in search_providers (such as professions, specialties, and filters) require exact value strings from this endpoint. Calling it first ensures your filter strings match what the directory recognizes and avoids empty results.What location data is available for providers?+
search_providers returns a summary location field per provider. get_provider_detail returns a full locations array where each entry includes lat, lon, and a formatted address. The address field in the detail response also includes the practice name. Bulk retrieval via get_all_providers returns the same summary-level location as search_providers, not the geocoordinates.Does the API cover support group meeting schedules or event listings?+
get_support_groups endpoint returns group contact information — name, slug, location, phone, email, and website — but no meeting schedules, event dates, or session details. You can fork this API on Parse and revise it to add an endpoint targeting support group detail pages if that data is available on the source site.Is there any limitation on how many providers can be retrieved in one call?+
search_providers and get_support_groups are paginated: each response includes page and total_pages so you can iterate. The get_all_providers endpoint handles iteration automatically up to a max_pages value you specify, returning a flat array. There is no single-call option to retrieve all results unbounded; omitting max_pages will use a default limit.