RateMDs reviews API documentation
We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:
- The RateMDs API returns 10 reviews per request.
- The order in which reviews are returned is by descending date(from newest to oldest).
- You can get all reviews from a single place by using the
offsetparameter.
To get reviews from Wextractor you will need to perform GET requests against
the https://wextractor.com/api/v1/reviews/ratemds endpoint.
Reviews endpoint parameters:
| Parameter | Required | Description | Example |
|---|---|---|---|
| auth_token | Required | Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. | - |
| id | Required | The full url in RateMDs | https://www.ratemds.com/doctor-ratings/68700/Dr-Tammy+L.-Leopold-New+York-NY.html/ |
| offset | Optional | This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.). | 10 |
Example usage:
https://wextractor.com/api/v1/reviews/ratemds?id=https%3A%2F%2Fwww.ratemds.com%2Fdoctor-ratings%2F68700%2FDr-Tammy%2BL.-Leopold-New%2BYork-NY.html%2F&auth_token=XXXXX&offset=0
Example response:
{
"reviews": [
{
"id": "4918100",
"datetime": "2022-04-30T00:18:48.349402-04:00",
"text": "The best internist in NYC. We are all waiting for her to return to private practice. Alas she left during the pandemic. I hope she reappears soon.",
"rating": "5.0",
"staff_rating": "5.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "4770535",
"datetime": "2021-09-22T17:43:47.877922-04:00",
"text": "Can anyone confirm if she retired? I'm also trying to find her. Thanks.",
"rating": "5.0",
"staff_rating": "5.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "4753431",
"datetime": "2021-08-27T12:31:50.544085-04:00",
"text": "Anyone know where she is practicing now? I am desperately trying to find her!",
"rating": "5.0",
"staff_rating": "5.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "4637390",
"datetime": "2021-03-13T11:51:41.837475-05:00",
"text": "Highly recommend Tammy! I was told by NYU Langone that she was retired when I called to ask where she is practicing now. I hope she did not!",
"rating": "5.0",
"staff_rating": "5.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "4592201",
"datetime": "2021-01-15T06:46:37.382269-05:00",
"text": "Tammy's terrific. Was told she's retired. Hope not",
"rating": "4.75",
"staff_rating": "5.0",
"punctuality_rating": "4.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "4572641",
"datetime": "2020-12-14T18:43:26.314906-05:00",
"text": "She is the best primary I’ve ever had. She’s left NYU Langone and I’d love to know where she’s practicing now. I miss her!",
"rating": "4.5",
"staff_rating": "3.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "4523909",
"datetime": "2020-10-05T02:30:17.367834-04:00",
"text": "The best! She is no longer at this location. Would like to know where she is now.",
"rating": "4.0",
"staff_rating": "5.0",
"punctuality_rating": "1.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "3541214",
"datetime": "2017-07-25T18:06:58.178937-04:00",
"text": "Dr. Leopold was simply AWESOME. She took her time to address every concern. I didn't feel rushed at all which made me feel more comfortable to ask questions. She was kind and thoughtful with her answers. I would say run, don't walk to Dr. Leopold. It's so hard to find a doctor who is great at what they do, has a great bedside manner, and genuinely makes you feel as if they hear you. I trust Dr. Leopold and you will too. ",
"rating": "5.0",
"staff_rating": "5.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "3076360",
"datetime": "2016-03-16T10:35:45.374352-04:00",
"text": "Dr. Leopold has always been a great doctor for me. Always takes time to listen and never seems in a hurry to get to the next patient. And she gives me answers I can understand, not doctor speak so I really know about my health. Thanks for being great!",
"rating": "5.0",
"staff_rating": "5.0",
"punctuality_rating": "5.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
},
{
"id": "1479025",
"datetime": "2013-02-03T01:29:25-05:00",
"text": "Good doctor, very helpful and kind. Helped solve my problem quickly. Will recommend to friends",
"rating": "4.5",
"staff_rating": "4.0",
"punctuality_rating": "4.0",
"helpfulness_rating": "5.0",
"knowledge_rating": "5.0",
"visible": true
}
],
"totals": {
"review_count": 32,
"average_rating": "4.598538306451612"
},
"doctor_details": {
"id": 2033902,
"facet_url": "/best-doctors/?specialty=family-gp",
"full_name": "Dr. Tammy L. Leopold",
"location": {
"id": 2033803,
"category": "clinic",
"created": "2014-06-14T17:21:56.444229-04:00",
"modified": "2016-03-11T11:50:55.080666-05:00",
"longitude": -74.006,
"latitude": 40.7143,
"slug": "us-ny-new-york-195-196-197-198-199-200-201-202-203-204-205-206-207-208-209",
"city": {
"id": 25,
"province_name": "New York",
"province_slug": "ny",
"country_name": "United States",
"country_slug": "us",
"cover_images": {
"autoxauto": "https://cdn1.ratemds.com/media/locations/city/new-york.jpg",
"253x83": "https://cdn1.ratemds.com/media/locations/city/new-york.jpg_thumbs/v1_at_253x83.jpg"
},
"modified": "2020-09-17T17:40:30.275251-04:00",
"created": "2014-06-25T11:34:15.276909-04:00",
"deleted": false,
"slug": "new-york",
"name": "New York City",
"cover_image": "https://cdn1.ratemds.com/media/locations/city/new-york.jpg",
"province": 17
},
"suite_on_display": null,
"name": "Tammy L. Leopold Clinic New York City",
"address": "355 W 52th St",
"suite": null,
"postal_code": "10019",
"city_id": 25,
"phone_number": null,
"website": "http://medicine.med.nyu.edu",
"image": null,
"url": "/clinic/us-ny-new-york-195-196-197-198-199-200-201-202-203-204-205-206-207-208-209/",
"geocode_address": "tammy l. leopold clinic new york city, 355 w 52th st, new york city, new york, united states, 10019"
},
"rating": {
"helpfulness": 4.75,
"bestRating": 5.0,
"average": 4.598538306451612,
"staff": 4.61290322580645,
"punctuality": 4.21875,
"knowledge": 4.8125,
"count": 32
}
}
}
Frequently asked questions:
- How do I get all the reviews for a single place?
- Does the API have rate limits?
You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.
Yes, since RateMDs is pretty strict at blocking requests you will be rate limited if you perform more than ten requests per second.