{"uid":"cap_akUm69ZPCjmnI_Qbz9xyW","slug":"findmydirectdoctor-directory-api-doctors-by-language-950db1d2","name":"FindMyDirectDoctor Directory API – Doctors by Language","description":"Spanish-speaking cash-pay doctor nearby. Doctors in a cash-pay and membership directory who speak a language such as Spanish, Mandarin, Hindi, Arabic or Vietnamese, near a ZIP, city or coordinates. Each result says whether the clinician or only the practice staff is stated to speak it, with source grade and page. Filters by specialty, credential, practice model and insurance stance. Languages come only from the practice's own site, so a rare language may return no match.","url":"https://api.findmydirectdoctor.com/v1/doctors/by-language?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["language"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees. Used together with lng."},"lng":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees. Used together with lat."},"zip":{"type":"string","pattern":"^\\d{5}$","maxLength":5,"description":"5-digit US ZIP code. A location is zip, or lat with lng, or city with state."},"city":{"type":"string","maxLength":80,"description":"City name. Used together with state; resolves only for cities that have listed doctors."},"limit":{"type":"integer","default":10,"maximum":25,"minimum":1,"description":"Results per page (maximum 25)."},"model":{"enum":["dpc","concierge","cash_specialist","any"],"type":"string","default":"any","description":"Practice model: dpc, concierge, cash_specialist or any."},"scope":{"enum":["doctor","practice","any"],"type":"string","default":"any","description":"doctor = the clinician is stated to speak it. practice = only the practice or staff. any (default) = either, labelled in the result."},"state":{"type":"string","pattern":"^[A-Za-z]{2}(,[A-Za-z]{2}){0,4}$","maxLength":14,"description":"2-letter US state code. With city it names the city's state. On its own it limits results to that state (up to 5 codes separated by commas)."},"cursor":{"type":"string","maxLength":40,"description":"Opaque next_cursor value from the previous response, to fetch the next page with the same other parameters."},"format":{"enum":["concise","detailed"],"type":"string","default":"concise","description":"concise = key fields. detailed = every field we hold."},"language":{"type":"string","maxLength":40,"description":"Required. Language a clinician or practice speaks, for example Spanish, Hindi, Mandarin, Arabic, French or Vietnamese."},"insurance":{"enum":["does_not_bill","bills_some_services","accepts_hsa_fsa","keep_insurance_for_emergencies","bills_insurance","any"],"type":"string","description":"What the practice states about insurance: does_not_bill, bills_some_services, accepts_hsa_fsa, keep_insurance_for_emergencies, bills_insurance or any."},"specialty":{"type":"string","maxLength":80,"description":"Specialty label or group, for example family-medicine, psychiatry, dermatology, mental-health, womens-health. Matched against the FindMyDirectDoctor directory label."},"credential":{"enum":["MD","DO","NP","PA","other","physician"],"type":"string","description":"Clinician type: MD, DO, NP (nurse practitioner), PA (physician assistant), other (for example naturopathic or counselor) or physician (MD or DO)."},"radius_miles":{"type":"number","default":25,"maximum":100,"minimum":0,"description":"Search radius in miles (maximum 100). Used with a location."},"verified_only":{"enum":["true","false"],"type":"string","description":"true keeps only matches whose supporting fact is graded A or B (registry, board, hospital bio, or a second source). Default false."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["total_matches","results","data_as_of"],"properties":{"count":{"type":"integer"},"query":{"type":"object","description":"The filters as understood, with any notes."},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","description":"One clinician. Fields not stated by the practice are null or absent."}},"returned":{"type":"integer"},"data_as_of":{"type":"string"},"disclaimer":{"type":"string"},"next_cursor":{"type":["string","null"]},"coverage_note":{"type":"string"},"total_matches":{"type":"integer"},"statement_basis":{"type":"string","description":"Facts are what the practice states on its own site, with a source grade."}}}}}}},"responseSchema":{"type":"json","example":{"count":10,"query":{"limit":10,"format":"concise","language":"Spanish","location":"ZIP 33133","radius_miles":15},"source":"FindMyDirectDoctor directory","results":[{"city":"Miami","name":"Camilo Andres Murillo","state":"FL","website":"https://www.directprimarycareofcoconutgrove.com/","evidence":{"as_of":"2026-10-27","basis":["own_site"],"grade_min":"C"},"doctor_id":"fd_s2fxt2aenp","language_note":"Languages are what the practice site states. 'practice' means the clinic or staff, not necessaril...","practice_name":"Direct Primary Care of Coconut Grove","distance_miles":2.3,"practice_model":"concierge","practice_phone":"305-812-2208","specialty_label":"Family Medicine","credential_class":"NP","credentials_text":"APRN","languages_listed":[{"grade":"C","language":"French","stated_for":"practice"},{"grade":"C","language":"Portuguese","stated_for":"practice"}],"matched_language":{"grade":"C","language":"Spanish","stated_for":"the practice only"},"location_precision":"city"},{"city":"Miami","name":"Paola Garcia-Herreros","state":"FL","website":"https://www.theconciergepediatrics.com/","evidence":{"as_of":"2026-10-27","basis":["npi_registry","own_site"],"grade_min":"C"},"doctor_id":"fd_ozywjib24u","language_note":"Languages are what the practice site states. 'practice' means the clinic or staff, not necessaril...","practice_name":"The Concierge Pediatrics","distance_miles":2.3,"practice_model":"concierge","specialty_label":"Pediatrics","credential_class":"NP","credentials_text":"APRN","languages_listed":[{"grade":"C","language":"Spanish","stated_for":"clinician"}],"matched_language":{"grade":"C","language":"Spanish","stated_for":"the clinician"},"location_precision":"city"}],"returned":10,"data_as_of":"2026-10-02","disclaimer":"Prices and availability change. Confirm directly with the practice before making care decisions.","next_cursor":"bzoxMA==","coverage_note":"Directory of cash-pay, direct primary care (DPC) and concierge practices, not every doctor.","total_matches":14,"statement_basis":"Facts are shown as the practice or publisher states them. Grade A = federal registry, board or ho..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PtD7cvRJ3vWMg-oMPAent","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds cash-pay, DPC, and concierge doctors near a location who speak a specified language, with per-result notes on whether the clinician or only staff speaks it.","exampleAgentPrompt":"Find me Spanish-speaking doctors near ZIP 33133 in the FindMyDirectDoctor directory — show up to 10 results, and make sure you flag whether it's the actual doctor or just the practice staff who speaks Spanish, using the 'any' scope.","exampleUseCases":[{"title":"Multilingual DPC doctor for immigrant family","prompt":"I need a direct primary care doctor near ZIP 77002 in Houston who speaks Vietnamese — ideally the doctor themselves, not just the staff. Can you find up to 10 options and tell me whether each one is the clinician or just the practice that speaks the language?"},{"title":"Spanish-speaking concierge pediatrician search","prompt":"My family is looking for a concierge pediatrician near Miami who speaks Spanish. Can you search for concierge-model doctors near ZIP 33133 who list Spanish, and show me the practice name, phone, and whether the doctor personally speaks it?"},{"title":"Hindi-speaking cash-pay specialist in New York","prompt":"I'm looking for a cash-pay specialist near New York City who speaks Hindi — can you search by city New York, state NY, filter to cash_specialist practice model, and return up to 15 results with detailed info?"}],"resultDescription":"A paginated JSON list of matching clinicians with their name, practice name, distance in miles, specialty, credentials, practice model, phone, website, and a matched_language object showing which language matched, whether the clinician or practice/staff speaks it, and an evidence grade. Also includes a next_cursor for pagination, data freshness date, and a coverage disclaimer.","failureModes":["Rare language returns zero results — the directory only reflects what practices publish on their own sites","Invalid or unsupported language string returns empty results or an error","ZIP code not recognized returns no results","City+state combination that has no listed doctors returns empty list","Cursor value from a different query set causes a pagination mismatch or error","Exceeding the limit of 25 per page returns a validation error"],"whenToPreferThis":"Use this endpoint when the user's primary filter is a spoken language and they need cash-pay, DPC, or concierge doctors (not insurance-billed practices). It is uniquely suited for finding multilingual clinicians in non-traditional practice models with evidence grading on whether the doctor personally speaks the language. Prefer it over generic physician directory APIs when language access and practice model (DPC, concierge, cash) are central requirements.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:34.732Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-directory-api-doctors-by-language-950db1d2"}