# Doctoralia — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find healthcare specialists in Brazil with their profiles, contact details, Instagram handles, pricing, and patient reviews all in one place. Search and discover doctors by specialty with autocomplete suggestions to quickly locate the right professional for your needs.

**Category:** Healthcare | **Website:** [doctoralia.com.br/](https://doctoralia.com.br/) | **Docs:** [parse.bot/marketplace/cf32883b-56e8-4657-b9ff-00a5ede5366c/doctoralia-com-br-api](https://parse.bot/marketplace/cf32883b-56e8-4657-b9ff-00a5ede5366c/doctoralia-com-br-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-doctoralia-com-br-api-cf32883b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_specialist_phone

Retrieve the full phone number(s) for a specific address. The address_id can be obtained from search_specialists results (each doctor entry includes an address_id field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address_id` | string | Yes | Address ID from search_specialists results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-doctoralia-com-br-api-cf32883b/get_specialist_phone \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address_id":"<string>"}'
```

### get_specialist_profile

Get the full profile of a specialist including Instagram handle and booking data (services, prices, addresses, insurances). Requires the specialist's profile URL or path. The booking_data object contains detailed service options with pricing, accepted insurances, and address info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL or path of the specialist profile page (e.g., 'https://www.doctoralia.com.br/lahis-salden/dermatologista/sao-paulo'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-doctoralia-com-br-api-cf32883b/get_specialist_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_specialist_reviews

Get paginated patient reviews for a specific doctor. Returns HTML content of reviews along with total count and page size. The doctor_id can be obtained from search_specialists results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `doctor_id` | string | Yes | Doctor ID from search_specialists results. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-doctoralia-com-br-api-cf32883b/get_specialist_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"doctor_id":"<string>","page":"<integer>"}'
```

### search_autocomplete

Autocomplete search for specialties, doctors, or facilities using Algolia. Returns matching hits with metadata including URLs, ratings, and specializations. Useful for discovering valid specialty slugs and doctor profile URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index` | string | No | Algolia index to search. |
| `query` | string | Yes | Search query text (e.g., 'dermatologista', 'psiquiatra'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-doctoralia-com-br-api-cf32883b/search_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index":"<string>","query":"<string>"}'
```

### search_specialists

Search for healthcare specialists by specialty and city. Returns paginated results with doctor summaries including ratings, review counts, and addresses. Each result carries a doctor_id and address_id for drilling into phone numbers and reviews via separate endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City slug (e.g., 'sao-paulo', 'belo-horizonte', 'rio-de-janeiro'). |
| `page` | integer | No | Page number for pagination. |
| `specialty` | string | Yes | Specialty slug (e.g., 'dermatologista', 'psiquiatra', 'dentista'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-doctoralia-com-br-api-cf32883b/search_specialists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>","specialty":"<string>"}'
```