psychologytoday.com APIwww.psychologytoday.com ↗
Access Psychology Today's therapist directory via API. Filter by US state and specialty, retrieve name, credentials, role, and location for up to 20 therapists per page.
curl -X GET 'https://api.parse.bot/scraper/9e95be20-8fa9-4b45-8ab4-ed2c718543d9/get_therapists_page?page=1&state=california&category=anxiety' \ -H 'X-API-Key: $PARSE_API_KEY'
Get therapists from a single page of the directory. Returns up to 20 therapists per page with name, credentials, role, and location details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| state | string | US state name in lowercase (used in URL path). Examples: alabama, california, new-york. |
| category | string | Specialty category filter. Examples: adhd, anxiety, depression. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"therapists": "array of therapist objects with name, credentials, role, city, state, state_code, zip_code, and location fields",
"total_results": "integer, total therapists matching the filter",
"therapists_on_page": "integer, number of therapists returned on this page"
},
"sample": {
"data": {
"page": 1,
"therapists": [
{
"city": "Mobile",
"name": "Anna Lambert",
"role": "COUNSELOR",
"state": "Alabama",
"location": "Mobile, AL 36609",
"zip_code": "36609",
"state_code": "AL",
"credentials": "MS, ALC"
}
],
"total_results": 1307,
"therapists_on_page": 20
},
"status": "success"
}
}About the psychologytoday.com API
The Psychology Today API provides 2 endpoints for querying the therapist directory at psychologytoday.com, returning up to 20 therapist records per page with fields including name, credentials, role, city, state, state code, and zip code. The get_all_therapists endpoint handles pagination automatically, while get_therapists_page lets you fetch a single page with precise control over state and specialty filters.
Endpoints and Filtering
The API exposes two endpoints: get_therapists_page and get_all_therapists. Both accept a state parameter (lowercase US state name, e.g. california, new-york) and a category parameter for specialty filtering (e.g. adhd, anxiety, depression). get_therapists_page also accepts a page integer for direct access to any page of results. Each request scoped to a state and category returns only therapists matching that combination.
Response Shape
Both endpoints return a therapists array. Each therapist object contains name, credentials, role, city, state, state_code, zip_code, and a location field. The get_therapists_page endpoint also returns page (current page number), total_results (total matching therapists), and therapists_on_page (count of records in the current response, up to 20). The get_all_therapists endpoint returns therapists_fetched in place of therapists_on_page, reflecting the total records actually retrieved across all pages.
Pagination Behavior
get_all_therapists iterates through all pages automatically, with a 1-second delay between page fetches. Pass max_pages to cap the number of pages retrieved — useful when you only need a sample or want to stay within a processing budget. Without max_pages, the endpoint will continue until all results are retrieved. For large states without a category filter, this can mean hundreds of pages.
- Build a therapist lookup tool filtered by US state and mental health specialty like anxiety or depression
- Aggregate therapist credential types (e.g. LCSW, PhD, PsyD) across different states for workforce analysis
- Map therapist density by zip code using the zip_code and location fields returned per record
- Compile specialty-specific directories by querying the category parameter across multiple conditions
- Track directory size over time by comparing total_results for a given state and category filter
- Populate a referral database with therapist names, roles, and locations for a given 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.
Does Psychology Today offer an official developer API?+
What does the category parameter filter on?+
category parameter filters results to therapists listed under a specific specialty in the directory, such as adhd, anxiety, or depression. It maps to Psychology Today's specialty browse paths. Not every specialty slug is documented here; you can test slugs that match the category names visible on the site.