# Doctoralia Doctor Profile Scraper

> Doctoralia Doctor Profile Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-02).

Scrapes structured doctor and specialist profiles from Doctoralia across multiple countries, including specializations, license numbers, locations, services, prices, and public reviews.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/doctoralia?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/doctoralia-doctor-profile-scraper-01622cda
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SSpCCg0QqQOkUqkzMLrhs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability doctoralia-doctor-profile-scraper-01622cda -d '<json body>'
```

Example prompt: Pull me up to 50 dermatologist profiles from Doctoralia Spain, searching in Madrid and Barcelona, with full profile details and up to 5 reviews per doctor — I need their license numbers, specializations, locations, and prices.

## When to prefer this

Choose this endpoint when you need structured, bulk doctor profile data from Doctoralia across Spain, Brazil, Mexico, Poland, Italy, Chile, Colombia, Peru, Turkey, Czech Republic, or Germany. It is ideal for healthcare market research, building medical directories, competitive pricing analysis, or enriching CRM data with verified specialist information. Prefer this over generic web scrapers when you need normalized, deduplicated doctor records with license numbers, specializations, and review data in a single structured response.

## Known failure modes

- Empty results if specialty or city slugs are invalid or misspelled
- Country/city combination returns no listings
- Doctoralia blocks scraping, resulting in failed run (not charged)
- maxDoctors cap reached before all results retrieved
- Profile detail fetch fails for individual doctors if pages are protected
- Invalid country enum value causes schema validation error

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count and an array of doctor records, each containing the doctor's profile URL, name, doctor ID, name prefix, license label, license number, primary specialization, and full specializations list. When fetchProfileDetails is enabled, additional data such as biography, locations, services, prices, payment methods, and public reviews are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cities": {
   "type": "array",
   "description": "City URL slugs, such as barcelona. Leave empty for a nationwide specialty search."
  },
  "country": {
   "enum": [
    "es",
    "br",
    "mx",
    "pl",
    "it",
    "cl",
    "co",
    "pe",
    "tr",
    "cz",
    "de"
   ],
   "type": "string",
   "default": "es",
   "description": "Country site used for specialty and city searches."
  },
  "maxPages": {
   "type": "integer",
   "default": 25,
   "maximum": 25,
   "minimum": 1,
   "description": "Maximum pages to request for each specialty and city search. Search pages may repeat promoted doctors; duplicates are removed."
  },
  "startUrls": {
   "type": "array",
   "description": "Public search or doctor profile URLs on a supported country site. These override specialty and city filters."
  },
  "maxDoctors": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum doctor records in the run. Zero means no actor-side cap."
  },
  "specializations": {
   "type": "array",
   "description": "Specialty URL slugs, such as dermatologo. One search is run for each specialty and city pair."
  },
  "fetchProfileDetails": {
   "type": "boolean",
   "default": true,
   "description": "Open each doctor profile for full specialties, registration, biography, locations, services, prices, payment methods, and public reviews."
  },
  "maxReviewsPerDoctor": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 0,
   "description": "Number of public reviews to include from each profile page, up to the ten visible reviews. Requires profile details."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "name": null,
    "doctorId": null,
    "namePrefix": null,
    "licenseLabel": null,
    "licenseNumber": null,
    "specialization": null,
    "specializations": null
   }
  ],
  "product": "doctoralia"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/doctoralia-doctor-profile-scraper-01622cda/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
