{"uid":"cap__ssDZi8OdDmpfo_9FCbGl","slug":"healthgrades-provider-search-scraper-8c90ac47","name":"Healthgrades Provider Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/healthgrades?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"location":{"type":"string","description":"City and state or ZIP code for the search."},"maxItems":{"type":"integer","default":100,"maximum":1000000,"minimum":0,"description":"Maximum number of unique providers to return. Set 0 to collect all available search pages."},"startUrl":{"type":"string","description":"A public Healthgrades /usearch URL. When set, it takes priority over the search query and location."},"searchQuery":{"type":"string","description":"Search term such as cardiologist, dentist, or a doctor name."},"includeDetails":{"type":"boolean","default":false,"description":"Visit each provider profile for biography, education, certifications, hospitals, conditions, procedures, languages, awards, and visible patient reviews."},"includeInsurancePlans":{"type":"boolean","default":false,"description":"Visit each provider profile for named plans and plan types under each insurer."},"includeOfficeContacts":{"type":"boolean","default":false,"description":"Visit each provider profile for all listed offices, phone and fax numbers, website, hours, and coordinates."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"npi":null,"name":null,"gender":null,"rating":null,"specialty":null,"providerId":null,"reviewCount":null,"specialties":null}],"product":"healthgrades"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dzzkjp3XtkpmyuGVZ1Uwa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes Healthgrades for structured healthcare provider listings including ratings, specialties, and optional detailed profiles via pay-per-call x402 micropayment.","exampleAgentPrompt":"Search Healthgrades for cardiologists in Boston, MA and give me up to 50 results with their ratings, specialties, and office contact information including phone numbers and hours.","exampleUseCases":[{"title":"Find rated specialists in a city","prompt":"Search Healthgrades for orthopedic surgeons in Denver, CO — I want up to 30 results with their star ratings and review counts so I can compare them."},{"title":"Build a doctor directory with insurance info","prompt":"Pull a list of up to 200 dermatologists in the 10001 ZIP code from Healthgrades, and include which insurance plans each one accepts."},{"title":"Detailed provider profile research","prompt":"Find psychiatrists in Seattle, WA on Healthgrades — give me full profiles including their education, certifications, conditions they treat, and all office locations with phone numbers. Return up to 25 providers."}],"resultDescription":"Returns a JSON object with a count of matched providers and an array of items, each containing NPI, name, gender, star rating, primary specialty, provider ID, review count, and specialties list. With optional flags enabled, also returns biography, education, certifications, hospitals, conditions, procedures, languages, awards, patient reviews, named insurance plans, office addresses, phone/fax numbers, website, hours, and GPS coordinates.","failureModes":["Empty result set if search query or location returns no Healthgrades matches — not charged","Network or scraping failure if Healthgrades changes page structure — not charged","Invalid or unreachable startUrl returns error","maxItems of 0 may result in very large response times for popular specialties","Location string not recognized by Healthgrades geolocation returns empty results"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable healthcare provider data from Healthgrades — especially when you need ratings, NPI numbers, specialty filters, and optionally deep profile data like insurance acceptance, office hours, or doctor credentials. Prefer this over general web scraping when targeting Healthgrades specifically, and over manual search when you need bulk provider data programmatically. The pay-only-on-success model makes it low-risk for exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:30.073Z","isFirstParty":false,"canonicalSlug":"healthgrades-provider-search-scraper-8c90ac47"}