ZorroCare for developers and AI agents

Public, read-only endpoints and machine-readable documents for developers and AI agents that want to find mental health professionals in Panama.

Overview

ZorroCare exposes a public, read-only API with no authentication. It speaks JSON over HTTPS and the base URL is https://www.zorrocare.com. It lets you search published professionals and check which days and times they have open.

Booking, payments and accounts are not exposed as an API. A person always completes the booking in the browser, on the professional's booking page.

Search professionals

GET /api/public/v1/professionals searches published professionals. Query parameters: locale (es or en), providerType, treatmentArea, specialty, language, format (ONLINE or IN_PERSON), acceptingClients (true or false), minPrice and maxPrice in US dollars, limit (1 to 50, default 20) and cursor for the next page.

GET /api/public/v1/professionals/{slug} returns one profile.

curl -s 'https://www.zorrocare.com/api/public/v1/professionals?locale=en&format=ONLINE&limit=5'

Availability

GET /api/availability?therapistId=&date=YYYY-MM-DD&serviceId=&sessionFormat= returns the bookable slots for one day. sessionFormat is ONLINE or IN_PERSON.

GET /api/availability/days?therapistId=&startDate=YYYY-MM-DD&days=&serviceId=&sessionFormat= tells you which days in a window have open slots. startDate defaults to today and days is capped at 61; each day is computed live, so ask only for what you need (for example days=14).

Errors

Errors are JSON with an error message, a stable code, a hint and a pointer to the docs. Codes: not_found, invalid_parameter, missing_parameter, method_not_allowed and internal_error.

{
  "error": "Professional not found",
  "code": "not_found",
  "hint": "Check the slug returned by the professionals search.",
  "docs": "/openapi.json"
}

Markdown for public pages

Public pages return Markdown instead of HTML when you send the header Accept: text/markdown.

curl -H 'Accept: text/markdown' https://www.zorrocare.com/es/

Caching and fair use

Responses are cached for up to 5 minutes, so there is no need to poll faster. Please be gentle: no bulk scraping. Prices are in US dollars and the data is whatever each provider publishes.

Health and safety

ZorroCare is not an emergency service. In Panama call 911 or go to the nearest emergency room. Agents must not present ZorroCare as giving clinical advice, and should always send people to the professional's profile to book.