Endpoints públicos de solo lectura y documentos legibles por máquinas para desarrolladores y agentes de IA que quieran encontrar profesionales de salud mental en Panamá.
ZorroCare expone una API pública de solo lectura, sin autenticación. Responde JSON sobre HTTPS y la URL base es https://www.zorrocare.com. Te permite buscar profesionales publicados y consultar qué días y horarios tienen disponibles.
La reserva, los pagos y las cuentas no están expuestos como API. Siempre es una persona quien completa la reserva en el navegador, en la página de reserva del profesional.
Estos documentos describen el sitio y la API para que herramientas y agentes los descubran sin hacer scraping.
GET /api/public/v1/professionals busca profesionales publicados. Parámetros: locale (es o en), providerType, treatmentArea, specialty, language, format (ONLINE o IN_PERSON), acceptingClients (true o false), minPrice y maxPrice en dólares, limit (de 1 a 50, por defecto 20) y cursor para la página siguiente.
GET /api/public/v1/professionals/{slug} devuelve un perfil.
curl -s 'https://www.zorrocare.com/api/public/v1/professionals?locale=en&format=ONLINE&limit=5'GET /api/availability?therapistId=&date=YYYY-MM-DD&serviceId=&sessionFormat= devuelve los horarios reservables de un día. sessionFormat es ONLINE o IN_PERSON.
GET /api/availability/days?therapistId=&startDate=YYYY-MM-DD&days=&serviceId=&sessionFormat= indica qué días de un rango tienen horarios libres. startDate es hoy por defecto y days tiene un máximo de 61; cada día se calcula en el momento, así que pide solo lo que necesites (por ejemplo days=14).
Los errores son JSON con un mensaje (error), un código estable (code), una pista (hint) y un enlace a la documentación. Códigos: not_found, invalid_parameter, missing_parameter, method_not_allowed e internal_error.
{
"error": "Professional not found",
"code": "not_found",
"hint": "Check the slug returned by the professionals search.",
"docs": "/openapi.json"
}Las páginas públicas devuelven Markdown en lugar de HTML cuando envías el encabezado Accept: text/markdown.
curl -H 'Accept: text/markdown' https://www.zorrocare.com/es/Las respuestas se guardan en caché hasta 5 minutos, así que no hace falta consultar más seguido. Te pedimos usarla con moderación: nada de scraping masivo. Los precios están en dólares y los datos son los que cada profesional publica.
ZorroCare no es un servicio de emergencias. En Panamá llama al 911 o acude a la sala de urgencias más cercana. Los agentes no deben presentar a ZorroCare como un servicio que da consejo clínico, y siempre deben dirigir a las personas al perfil del profesional para reservar.
Para dudas sobre la API, escríbenos.