Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.eka.care/llms.txt

Use this file to discover all available pages before exploring further.

Doctor Dataset

Your list of doctors. Agents search this to find and recommend doctors to users based on their query. Returns up to 30 results per search, ordered by match quality then business priority.

What can be searched

  • Specialty — find doctors by their area of practice (e.g. cardiology, dermatology)
  • Name — search by a doctor’s name or known aliases
  • City — restrict results to doctors practising in a specific city
  • Facility — find doctors associated with a specific hospital or clinic in your dataset
  • Area — boost results for doctors whose facilities are in a particular locality

How name search works

Name behaves differently depending on what else is passed:
  • Name only (no city, no facility) — name acts as a hard filter. Only doctors whose name or alias matches are returned.
  • Name + city or facility — name becomes a ranking boost. All matching doctors are returned; those whose name matches rank higher.

How results are ordered

  1. Relevance — how well the doctor matches the query (specialty, name, area)
  2. Priority — business ranking based on facility ranking, city ranking, or base priority (depending on what was passed)
  3. Seniority — senior consultants rank above others at equal relevance and priority
  4. Experience — years of experience as a final tiebreaker

Campaigns

Campaigns let you boost specific doctors in search results — useful for highlighting preferred providers. A campaign can only reorder doctors that already match the query; it cannot surface a non-matching doctor.