# Doctoralia Brazil Reviews Scraper (`muhammetakkurtt/doctoralia-brazil-reviews-scraper`) Actor

This Apify actor collects doctor reviews and ratings from the doctoralia.com.br website. Users can search by specific specialties and cities. The actor pulls data such as doctor ID, review score, review text and review date and presents it in a structured format.

- **URL**: https://apify.com/muhammetakkurtt/doctoralia-brazil-reviews-scraper.md
- **Developed by:** [Muhammet Akkurt](https://apify.com/muhammetakkurtt) (community)
- **Categories:** Other
- **Stats:** 30 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 reviews

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Doctoralia Brazil Reviews Scraper](https://github.com/user-attachments/assets/f5aa956b-a948-4fe2-974f-b43f28f8f42c)

## Doctoralia Brazil Reviews Scraper

The **Doctoralia Brazil Reviews Scraper** is a powerful data extraction tool designed to scrape patient reviews, ratings, and doctor profiles from [doctoralia.com.br](https://www.doctoralia.com.br/). Whether you need to analyze healthcare trends, monitor doctor reputation, or gather medical market data in Brazil, this Apify Actor provides a reliable and efficient solution.

### What can this Doctoralia Scraper do?

This scraper allows you to extract detailed data from one of Brazil's leading medical platforms. It supports flexible input methods, allowing you to search by criteria or scrape specific search result pages directly.

Key features include:

- **Scrape Doctor Reviews**: Get patient feedback, ratings, and review dates.
- **Doctor Profiles**: Extract doctor names, IDs, and profile URLs.
- **Filter by Specialty**: Target specific medical fields like Cardiology, Dermatology, etc.
- **Filter by Location**: Narrow down your search to specific cities or regions.
- **Direct URL Scraping**: Paste a specific search URL from Doctoralia to scrape exactly what you see.
- **Export Data**: Download data in JSON, CSV, Excel, XML, and more.

### Why scrape Doctoralia Brazil?

Scraping medical review platforms like Doctoralia typically serves several use cases:

- **Market Research**: Analyze the supply and demand for medical services in different Brazilian cities.
- **Sentiment Analysis**: Understand patient satisfaction and common complaints across different specialties.
- **Reputation Management**: Monitor feedback for specific doctors or clinics.
- **Lead Generation**: Identify popular doctors and clinics for B2B healthcare services.

### How to scrape Doctoralia Brazil reviews

It's easy to get started with the Doctoralia Brazil Reviews Scraper. You can choose between two methods:

#### Method 1: Search by Specialty and City

1. **Create a free Apify account** if you don't have one already.
2. Open the **Doctoralia Brazil Reviews Scraper** on the Apify Store.
3. Set the `specialization` input (e.g., *cardiologista*, *ginecologista*).
4. Set the `city` input (e.g., *São Paulo*, *Rio de Janeiro*).
5. Click **Start**.

#### Method 2: Direct URL

1. Go to [doctoralia.com.br](https://www.doctoralia.com.br/) and perform your desired search.
2. Copy the URL from your browser address bar.
3. Paste it into the `url` input field in the actor input.
4. Click **Start**.

*Note: If a direct URL is provided, the specialization and city inputs will be ignored.*

### Input Parameters

The input capability is straightforward and user-friendly:

| Field | Type | Description |
| --- | --- | --- |
| `specialization` | Array | List of medical specialties to search for (e.g., `["cardiologista", "ginecologista"]`). |
| `city` | String | The city where you want to search for doctors. |
| `url` | String | (Optional) Direct Doctoralia search URL. Overrides other inputs. |
| `proxyConfiguration` | Object | (Optional) Proxy settings. |

### Output Data

The scraper stores the results in a dataset. Each item represents a single review or doctor profile entry.

#### Example Output JSON

```json
{
  "doctor_id": "761703",
  "doctor_name": "Dr. Welber Meneses",
  "doctor_url": "https://www.doctoralia.com.br/welber-meneses/ortopedista-traumatologista/santos",
  "review_id": "7237106",
  "review_rating": 5,
  "review_text": "Foi muito atencioso na consulta.",
  "review_date": "2026-09-18T17:54:40-03:00",
  "is_anonymous": false,
  "doctor_answer": null,
  "doctor_answer_date": null,
  "fetch_time": "2026-09-21T20:46:08"
}
```

### How much will scraping Doctoralia cost?

This actor is designed to be efficient. The cost mainly depends on the number of results you scrape and the complexity of the pages.
Apify provides $5 USD of free credit every month on the Personal plan, which is usually sufficient for smaller scraping tasks. For large-scale data extraction, you can upgrade to a paid plan.

### Integrations

Since this scraper runs on the **Apify platform**, you can easily integrate it with other tools:

- **Cloud Storage**: Save results to Google Drive, AWS S3, etc.
- **Databases**: Push data to MongoDB, PostgreSQL, or Apify datasets.
- **Automation**: Schedule runs to monitor reviews daily or weekly.
- **API**: Access your data programmatically via the Apify API.

# Actor input Schema

## `specialization` (type: `array`):

Por favor, selecione as especialidades que devem ser pesquisadas. Mais de uma pode ser selecionada. (Please select the specialties to be scanned, more than one can be selected.)

## `city` (type: `string`):

Por favor, selecione a cidade a ser pesquisada. (Please select the city to scan)

## `url` (type: `string`):

Opcionalmente, voce pode fornecer um URL de busca direto do Doctoralia. Se fornecido, substituira a selecao de cidade e especialidade. (Optionally, you can provide a direct Doctoralia search URL. If provided, it will override city and specialization selection.)

## `proxyConfiguration` (type: `object`):

Using a proxy is recommended for faster and more reliable results

## Actor input object example

```json
{
  "specialization": [
    "infectologista"
  ],
  "city": "cuiaba",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}
```

# Actor output Schema

## `reviews` (type: `string`):

Every scraped review: rating, text, publication date (ISO 8601), anonymity flag, the doctor's reply and the doctor it belongs to

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammetakkurtt/doctoralia-brazil-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("muhammetakkurtt/doctoralia-brazil-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call muhammetakkurtt/doctoralia-brazil-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,muhammetakkurtt/doctoralia-brazil-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Cm9qyv1cWgPSrnX0d/builds/zIsqRjq209uzaZ91G/openapi.json