Ehlers-Danlos APIehlers-danlos.com ↗
Search EDS healthcare professionals and support groups by location, specialty, profession, and language. Access provider profiles with contact details and credentials.
What is the Ehlers-Danlos 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.
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'
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 ehlers-danlos-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.ehlers_danlos_society_directory_api import EhlersDanlos, Provider, ProviderDetail, SupportGroup, DirectoryFilter, FilterOption, ProviderNotFound
eds = EhlersDanlos()
# Get available filter options for the directory
filters = eds.providers.get_filters()
for opt in filters.professions[:3]:
print(opt.label, opt.value)
# Search for physical therapists in the United States
for provider in eds.providers.search(country="United States", professions="Physical Therapist/Physiotherapist"):
print(provider.name, provider.location, provider.profession)
# Get full details for a specific provider
detail = eds.provider("zahra-syed").detail.get()
print(detail.name, detail.practice_name, detail.phone)
for loc in detail.locations:
print(loc.lat, loc.lon, loc.address)
# Search support groups
for group in eds.supportgroups.search(country="United States"):
print(group.name, group.email, group.website)
Search the healthcare professionals directory with optional filters for country, state, profession, specialty, language, and program flags. Returns paginated results sorted by last updated. Each provider summary includes name, slug, profession, specialties, location, phone, email, and website. Use get_directory_filters to discover valid filter values.
| 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": "Jane Doe, L.Ac., D.Ac.",
"slug": "zahra-syed",
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"website": "",
"location": "McLean, VA, United States",
"profession": "Acupuncturist",
"specialties": "Traditional Chinese Medicine"
}
],
"total_pages": 259
},
"status": "success"
}
}About the Ehlers-Danlos API
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.
The Ehlers-Danlos API is a managed, monitored endpoint for ehlers-danlos.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ehlers-danlos.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 ehlers-danlos.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 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 | 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 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.