REST API quickstart#

The API uses JSON over HTTPS. Its production origin is:

https://www.doctosan.com/api/v1

1. Create a key#

Create and copy a key in the developer console. Put it in a server environment variable:

export DOCTOSAN_API_KEY='dct_live_replace_me'

2. Search the directory#

country is required. This example asks for published Madrid records whose primary phone appears technically capable of receiving WhatsApp messages:

curl --get 'https://www.doctosan.com/api/v1/doctors' \
  --header "X-API-Key: $DOCTOSAN_API_KEY" \
  --data-urlencode 'country=es' \
  --data-urlencode 'city=madrid' \
  --data-urlencode 'whatsapp=true' \
  --data-urlencode 'limit=25'

3. Read the response#

{
  "doctors": [
    {
      "id": "ChIJ…",
      "name": "Clínica Dental Example",
      "phone": "+34600111222",
      "phoneType": "mobile",
      "whatsappEligible": true,
      "verified": false,
      "profileUrl": "https://www.doctosan.com/es/es/dentista/madrid/clinica-dental-example/"
    }
  ],
  "page": {
    "count": 1,
    "hasMore": false,
    "nextCursor": null
  }
}

Continue with the complete Doctors endpoint and pagination contracts.

Public records

The API returns only records whose publication status is published, through an explicit field allowlist. Internal crawl and publication metadata is never part of the response.