{"uid":"cap_x6TPOU6FMmjZ2-YbuIJvo","slug":"healthgrades-doctor-search-by-specialty-and-city-f4283d8f","name":"Healthgrades Doctor Search by Specialty and City","description":"Doctors near a US city from Healthgrades' specialty directory (family practice, dermatology, cardiology...): up to 20 providers with name, NPI, Healthgrades ID, specialty, rating and review counts, practice address, distance, gender, age, new-patient and telehealth flags, appointment availability, number of accepted insurance plans and profile link.","url":"https://api.jobsproperty-api.workers.dev/api/realestate/healthgrades?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":["specialty","state","city"],"properties":{"city":{"type":"string","description":"City name, e.g. Austin"},"limit":{"type":"string","description":"Providers, 1 to 20 (default 20)"},"state":{"type":"string","description":"Two-letter US state code, e.g. TX"},"specialty":{"type":"string","description":"Healthgrades directory slug, e.g. family-practice, dermatology, cardiology, pediatrics, orthopedic-surgery, psychiatry, obstetrics-gynecology"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DUVr1EHXhHlh3LFnHrUCY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns up to 20 doctors near a US city from Healthgrades' specialty directory, with name, NPI, rating, practice address, availability, and insurance info.","exampleAgentPrompt":"Can you find me a list of dermatologists near Austin, TX from Healthgrades — show me up to 10 providers with their ratings, whether they accept new patients, and if they offer telehealth?","exampleUseCases":[{"title":"Finding a new primary care doctor","prompt":"I just moved to Nashville, Tennessee and need to find a family practice doctor who's accepting new patients — can you pull up to 10 options from Healthgrades with their ratings and addresses?"},{"title":"Locating telehealth-friendly psychiatrists","prompt":"Can you search Healthgrades for psychiatrists near Seattle, WA and show me which ones offer telehealth appointments along with their ratings and insurance info?"},{"title":"Researching cardiologists before a referral","prompt":"My doctor gave me a referral to see a cardiologist in Houston, TX — can you find up to 20 cardiologists on Healthgrades there with their NPI numbers, ratings, and how many insurance plans they accept?"}],"resultDescription":"A list of up to 20 doctor profiles from Healthgrades including: full name, NPI number, Healthgrades provider ID, specialty, star rating, review count, practice address, distance from city center, gender, approximate age, whether they accept new patients, telehealth availability, appointment availability, number of accepted insurance plans, and a direct link to their Healthgrades profile page.","failureModes":["Missing required parameters (specialty, state, or city) returns a validation error","Invalid or unrecognized specialty slug may return zero results or an error","City not found in Healthgrades directory returns empty provider list","Limit value outside 1–20 range may be clamped or rejected","Healthgrades website structure changes may break scraping and return parsing errors","Rate limiting or upstream Healthgrades blocks may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need structured doctor/provider data from Healthgrades for a specific US city and medical specialty — especially when you need NPI numbers, new-patient status, telehealth flags, insurance acceptance counts, and appointment availability in a single call. Prefer this over general web search when you need structured, comparable provider records rather than narrative results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T13:42:59.811Z","isFirstParty":false,"canonicalSlug":"healthgrades-doctor-search-by-specialty-and-city-f4283d8f"}