Doctoralia API

Search Doctoralia doctors and clinics by specialty and city, with practice prices, health plans and reviews, as JSON.

The API.SH Doctoralia API turns public Doctoralia listings into structured JSON across its sites in Brazil, Spain, Mexico, Colombia, Chile, Peru, Argentina, Portugal, Italy, Poland, Turkey and Czechia. Search doctors and clinics for a specialty in a city, narrow by health plan or teleconsultation, and get each practice with its services and first-visit price. Then open a doctor's profile for every practice address, services with prices, accepted health plans, reviews and answered patient questions. Professional listing data only.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Doctoralia doctor search

GET https://api.api.sh/doctoralia/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Doctoralia API

Consultation price benchmarks

Search a specialty in a city and collect each practice's first-visit price and services to compare what dermatologists in Madrid or cardiologists in São Paulo charge.

/search /doctor

Health plan network mapping

Filter a search by health plan to see which doctors accept it, and read insurances_accepted on each profile to map a plan's network by city.

/search /doctor

Healthcare directory and lead lists

Build lists of practices with specialty, address, coordinates and practice phone for a medical supplier or software vendor's sales team.

/search /doctor

Reputation and review analysis

Pull rating, review count and the latest reviews for doctors or clinics to compare patient feedback across a specialty or a clinic group.

/doctor

Telemedicine market research

Search with online=true to count doctors offering teleconsultation per specialty and country, with their prices.

/search

Doctoralia data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Doctoralia API endpoints and prices

Every Doctoralia endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Doctoralia doctor search

/doctoralia/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

Doctoralia doctor profile

/doctoralia/v1/doctor

$1 · $2 PAYG

1 credit

Call the Doctoralia API

Doctoralia doctor search: GET https://api.api.sh/doctoralia/v1/search

curl "https://api.api.sh/doctoralia/v1/search?specialty=dermatologista&city=sao-paulo" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/doctoralia/v1/search",
    params={"specialty": "dermatologista", "city": "sao-paulo"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/doctoralia/v1/search");
url.searchParams.set("specialty", "dermatologista");
url.searchParams.set("city", "sao-paulo");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/doctoralia/v1/search", "specialty", "dermatologista", "city", "sao-paulo")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Doctoralia" and "Doctoralia doctor search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Doctoralia data

Public data only: no Doctoralia login, cookies or account needed
One key and one response shape for Doctoralia and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Doctoralia API

Doctoralia's parent Docplanner runs an integrations API for medical software providers to sync appointment slots and bookings for their own doctors; it is for partners, not open search data. API.SH needs no partnership and returns public doctor and clinic listings as JSON.

Rather than build a Doctoralia scraper per country site, call one API.SH endpoint with a country code and get the same JSON shape for all of them at a fixed price per call.

Doctoralia API questions

What Doctoralia data can I get?+

Doctor and clinic search by specialty and city with health plan and online filters (/doctoralia/v1/search), and full doctor profiles with practices, services and prices, health plans, reviews, patient questions, education and languages (/doctoralia/v1/doctor).

How much does the Doctoralia API cost?+

Every Doctoralia endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /doctoralia/v1/doctor at 1 credit each.

Is there an official Doctoralia API?+

Yes, for partners: the Docplanner integrations API lets medical software sync calendars and bookings for doctors who use it. It does not offer open search of listings. API.SH covers the public directory data.

Do I need a Doctoralia account or login?+

No. API.SH reads public Doctoralia pages only. No endpoint uses a login, cookies or anyone's account. It returns professional listing data, not patient records or bookings.

Doctoralia tem API aberta? (Does Doctoralia have an open API?)+

Not for general data access. The official Docplanner API is for integration partners. API.SH gives you public Doctoralia Brazil and other country listings with one key and no partner approval.

Which countries are covered?+

Brazil, Spain, Mexico, Colombia, Chile, Peru, Argentina, Portugal, Italy, Poland, Turkey and Czechia. Pass the country code to /doctoralia/v1/search; /doctoralia/v1/doctor takes any profile URL from these sites.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /doctoralia/v1/search with country=es, a specialty such as dermatologo and a city such as madrid. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.