doctoralia.com.br APIdoctoralia.com.br ↗
Search Brazilian healthcare specialists, retrieve full profiles, phone numbers, patient reviews, and autocomplete suggestions via the Doctoralia Brazil API.
curl -X GET 'https://api.parse.bot/scraper/565b99b6-ce1f-4f65-92d6-4d70c1e4c470/search_specialists?city=sao-paulo&page=1&specialty=dermatologista' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for healthcare specialists by specialty and city. Returns paginated results with doctor details including ratings, review counts, and addresses.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City slug (e.g., 'sao-paulo', 'belo-horizonte', 'rio-de-janeiro'). |
| page | integer | Page number for pagination. |
| specialtyrequired | string | Specialty slug (e.g., 'dermatologista', 'psiquiatra', 'dentista'). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"doctors": "array of doctor objects with doctor_id, address_id, name, url, rating, reviews_count, specialty, city, image, and address_full",
"total_on_page": "integer, number of doctors returned on this page"
},
"sample": {
"data": {
"page": 1,
"doctors": [
{
"url": "https://www.doctoralia.com.br/luiz-antonio-coelho-marques/dermatologista-cirurgiao-plastico/sao-paulo",
"city": "São Paulo",
"name": "Dr. Luiz Antonio Coelho Marques",
"image": "//pixel-p1.s3.sa-east-1.amazonaws.com/doctor/avatar/d96a7919/d96a7919-09e9-4c42-a49f-12eb9d2e2997_medium_square.jpg",
"rating": "5",
"doctor_id": "288013",
"specialty": null,
"address_id": "504072",
"address_full": "Rua Doutor Veiga Filho 350 conj 304, Santa Cecília, Higienópolis",
"reviews_count": "2070"
}
],
"total_on_page": 30
},
"status": "success"
}
}About the doctoralia.com.br API
The Doctoralia Brazil API exposes 5 endpoints covering specialist search, full doctor profiles, phone numbers, patient reviews, and autocomplete suggestions across Brazil. The search_specialists endpoint returns paginated doctor listings filtered by specialty slug and city slug, including ratings, review counts, and full addresses. The get_specialist_profile endpoint adds booking data with services, prices, and insurance networks alongside an Instagram handle when available.
Specialist Search and Profiles
The search_specialists endpoint accepts a required specialty slug (e.g., dermatologista, psiquiatra) and a required city slug (e.g., sao-paulo, rio-de-janeiro), returning an array of doctor objects with fields including doctor_id, address_id, name, url, rating, reviews_count, specialty, city, and address_full. Pagination is controlled with the optional page parameter, and total_on_page tells you how many results were returned for that page.
Full Profiles and Contact Data
get_specialist_profile takes a specialist's full URL or path and returns the complete profile: name, doctor_id, instagram (URL or null), json_ld structured data objects, and a booking_data object. The booking_data field includes nested addresses, specializations, services, service_options with individual prices, and accepted insurance networks. The get_specialist_phone endpoint resolves phone numbers from an address_id obtained in search results, returning an array of Brazilian-formatted phone strings.
Reviews and Autocomplete
get_specialist_reviews accepts a doctor_id and optional page parameter. The response includes an html string containing the review content, a limit field indicating reviews per page, and numRows as the total review count for that doctor. The search_autocomplete endpoint (POST) queries against three Algolia indexes — br_autocomplete_doctor, br_autocomplete_item, or br_autocomplete_facility — and returns hits with names and URLs, along with nbHits for total match count and a zero-indexed page field.
- Build a specialty directory for Brazilian cities by mapping
search_specialistsresults byspecialtyandcityslugs. - Display verified patient ratings and review counts on a doctor-comparison tool using
ratingandreviews_countfrom search results. - Retrieve insurance network coverage for a specific specialist via the
insurancesfield inbooking_datafromget_specialist_profile. - Collect service pricing for a given doctor using
service_optionsprices returned byget_specialist_profile. - Implement a doctor search autocomplete feature for a health app using the
search_autocompleteendpoint with thebr_autocomplete_doctorindex. - Build a lead-generation tool for medical clinics by extracting phone numbers via
get_specialist_phoneusingaddress_idvalues from search results. - Aggregate patient sentiment by fetching and parsing paginated review HTML via
get_specialist_reviewsusingnumRowsfor total coverage.
| 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 Doctoralia Brazil offer an official developer API?+
What does `booking_data` in `get_specialist_profile` actually contain?+
booking_data is a nested object that includes the specialist's addresses, specializations, available services, service options with prices, accepted insurance networks, and doctor metadata. It represents the information typically needed to evaluate and book a consultation.Are appointment booking or scheduling actions supported?+
How does pagination work for reviews, and what format are they returned in?+
get_specialist_reviews returns an html string for each page of reviews rather than structured data objects. Use numRows to calculate total pages given the limit value, and pass the page parameter to walk through them. Parsing the HTML into discrete review fields would require additional processing on your end.