Healthgrades API endpoint
Returns one Healthgrades Health A-Z or drug article: headline, description, authors, medical reviewers, published and modified dates, image, the conditions the article is tagged with, and the article body as headed sections of paragraphs and lists. Works for standard, chaptered, and slideshow articles. Requests use US egress because Healthgrades restricts content by region.
/healthgrades/health-articleQuery parameters:
url (required): a https://resources.healthgrades.com/right-care/<topic>/<article> or https://resources.healthgrades.com/drugs/<article> URL from /api/v1/healthgrades/health-articles. Other hosts or paths return 400; unknown articles return 404.Returns the article headline, label (for example PHYSICIAN VOICES) when shown, description, authors, reviewed_by (medical reviewers), date_published, date_modified, image_url, the conditions the article is tagged with, its topic, and the body as sections (each with an optional title from the article's headings, paragraphs, and lists; table rows appear as list items with cells joined by |). Standard, chaptered, and slideshow articles are all supported; slideshow slides become titled sections. Requests use US egress because Healthgrades restricts content by region.
| Field | In the sample | Value in the sample |
|---|---|---|
| url | Has a value | resources.healthgrades.com |
| slug | Has a value | |
| topic | Has a value | |
| headline | Has a value | 8 characters |
| description | Has a value | 199 characters |
| authors | Has a value | 1 entry |
| reviewed_by | Has a value | 1 entry |
| date_published | Has a value | 2021-11-01 |
| date_modified | Has a value | 2023-03-06 |
| conditions | Has a value | 3 entries |
| sections | Has a value | 35 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Article URL from /healthgrades/health-articles | https://resources.healthgrades.com/drugs/atenolol | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/healthgrades/health-article?url=https%3A%2F%2Fresources.healthgrades.com%2Fdrugs%2Fatenolol" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 0,
"message": "success",
"data": {
"url": "https://resources.healthgrades.com/drugs/atenolol",
"slug": "atenolol",
"topic": "drugs",
"headline": "Atenolol",
"authors": [
"University of Illinois Chicago Drug Information Group"
],
"reviewed_by": [
"University of Illinois Chicago Drug Information Group"
],
"date_published": "2021-11-01T20:47:19.267Z",
"date_modified": "2023-03-06T18:37:32.667Z",
"conditions": [
"Hypertension",
"Angina"
],
"sections": [
{
"title": "Atenolol at a glance",
"paragraphs": [
"Key highlights to know about atenolol are:"
],
"lists": [
[
"Atenolol is used to control high blood pressure, to help prevent angina (chest pain), and to increase survival after a heart attack."
]
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/healthgrades.healthArticleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | healthgrades.HealthArticleResponse | No | ||||
| data.authors | array | No | ||||
| data.conditions | array | No | ||||
| data.date_modified | string | No | ||||
| data.date_published | string | No | ||||
| data.description | string | No | ||||
| data.headline | string | No | ||||
| data.image_url | string | No | ||||
| data.label | string | No | ||||
| data.reviewed_by | array | No | ||||
| data.sections | array | No | ||||
| data.sections[].lists | array | No | ||||
| data.sections[].paragraphs | array | No | ||||
| data.sections[].title | string | No | ||||
| data.slug | string | No | ||||
| data.topic | string | No | ||||
| data.url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/healthgrades/health-article?url=https%3A%2F%2Fresources.healthgrades.com%2Fdrugs%2Fatenolol" \
-H "x-api-key: $CRAWLORA_API_KEY"