{"uid":"cap_ld7mGK0mfySdP9tH69P8r","slug":"healthgrades-provider-search-profile-scraper-82d7f315","name":"Healthgrades Provider Search & Profile Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_RBGA71rAbAWfvw64KCuJh","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 to return structured provider listings including NPI, ratings, specialties, office contacts, insurance plans, and full profile details for a given search query and location.","exampleAgentPrompt":"Search Healthgrades for cardiologists in Austin, TX and return up to 50 providers including their ratings, specialties, and office contact details like phone numbers, hours, and coordinates.","exampleUseCases":[{"title":"Find local specialists with insurance info","prompt":"Find me up to 100 dermatologists in Miami, FL on Healthgrades and include which insurance plans they accept so I can filter by my insurer."},{"title":"Research a specific doctor's background","prompt":"Look up Dr. Sarah Chen on Healthgrades and pull her full profile including education, certifications, hospital affiliations, and patient reviews."},{"title":"Build a provider directory for a neighborhood","prompt":"Get me a list of all primary care physicians in 90210 from Healthgrades — include their office addresses, phone numbers, hours, and star ratings, up to 200 providers."}],"resultDescription":"Returns a JSON object with a count and an array of provider items, each containing NPI, name, gender, rating, specialty, provider ID, review count, and specialties. When detail flags are enabled, also includes biography, education, certifications, hospitals, conditions treated, procedures, languages, awards, patient reviews, insurance plan names, office addresses, phone/fax numbers, websites, hours, and GPS coordinates.","failureModes":["Empty result set if search query or location returns no Healthgrades matches (not charged)","Invalid or inaccessible startUrl causing failed scrape (not charged)","Rate limiting or anti-scraping measures on Healthgrades causing partial or failed extraction","maxItems set too low to capture meaningful results","Malformed location string not recognized by Healthgrades search"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable provider data from Healthgrades — including ratings, specialties, insurance plans, and detailed profile information — without building your own scraper. It is ideal for healthcare directory applications, insurance verification workflows, or agent-driven doctor discovery where up-to-date Healthgrades data is required. Prefer it over general-purpose web scrapers when you need Healthgrades-specific schema output (NPI, provider ID, structured reviews) and pay-per-successful-call pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:58.640Z","isFirstParty":false,"canonicalSlug":"healthgrades-provider-search-profile-scraper-82d7f315"}