Healthgrades reviews
A healthcare provider's rating and patient reviews.
A healthcare provider's rating and patient reviews. A group practice answers with the
providers it names (profile.extra.providers) and no reviews: ask for each provider.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128since?stringOnly reviews posted or edited after this are returned, and paging stops there. No
zone means UTC. Leave out for a first check. A review dated only by day or month
counts as the end of that day or month, so the newest day's reviews come back again
on the next check: drop them by id.
date-timemax_reviews?integerThe most reviews to return; a larger number is held to 500. 0 asks for the profile alone.
0 <= value <= 500100country?stringThe country the page is loaded from, default us, when it is one of the countries below.
Countries a request can be made from: us, ca, mx, br, ar, au, nz, in, sg, jp, ph, ae, za, gb, ie, de, fr, es, it, nl, be, pt, at, ch, se, no, dk, fi, pl, cz, gr, ro, hu.
^[A-Za-z]{2}$profile_url*stringA provider's page (/physician/…, /providers/…) or a group practice's page.
healthgrades\.com/.+The profile and its reviews.
application/json- response
mode: "reviews". Site-specific fields are in profile.extra
and reviews[].extra; see each engine's document.
search_metadata*search_parameters*The request's own fields as sent, engine first, without cancel_token.
search_information*The parser's own, e.g. yelp_search's; otherwise {}.
profile*reviews*array<>Newest first.
has_more*booleanOlder reviews exist that were not returned (max_reviews, or the site shows no more).
reached_since*booleanPaging stopped at since.
reviews_status?stringPresent only when the list could not be read. blocked: reviews is [].
"blocked""limited"reviews_order?stringPresent only with reviews_status limited.
curl -X GET 'https://api.justserp.com/v1/healthgrades/reviews?profile_url=https%3A%2F%2Fwww.healthgrades.com%2Fphysician%2Fdr-jane-doe-ynd8d'{ "search_metadata": { "id": "string", "status": "Success", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": {}, "profile": { "url": "string", "site_id": "string", "name": "string", "address": "string", "phone": "string", "website": "string", "rating": 0, "rating_scale": 5, "review_count": 0, "claimed": true, "extra": {} }, "reviews": [ { "id": "string", "url": "string", "rating": 0, "recommended": true, "title": "string", "text": "string", "language": "string", "posted_at": "2019-08-24T14:15:22Z", "date_precision": "day", "updated_at": "2019-08-24T14:15:22Z", "author": { "name": "string", "id": "string", "url": "string", "review_count": 0, "location": "string" }, "owner_reply": { "text": "string", "posted_at": "2019-08-24T14:15:22Z" }, "photos": 0, "extra": {} } ], "has_more": true, "reached_since": true, "reviews_status": "blocked", "reviews_order": "most_relevant"}