RateMDs Reviews API

Overview

This API endpoint allows you to retrieve reviews from RateMDs. Here are some important things to know:

  • 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 offset parameter.

Endpoint

GET https://wextractor.com/api/v1/reviews/ratemds

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 Request

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=your_auth_token&offset=0

Example Response


{
  "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
    }
  },
  "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\u2019ve ever had. She\u2019s left NYU Langone and I\u2019d love to know where she\u2019s 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
    }
  ]
}

Error Codes

Status Code Error Type Description
400 InvalidRequest The request parameters are invalid or missing
401 Unauthorized Invalid or missing API key
403 Forbidden Your account is out of credits
429 RateLimitExceeded You've exceeded the API rate limit(10 requests per second)
500 ServerError An unexpected error occurred on our servers. In these cases we recommend to retry the request for a couple of times. If the error subsists you can reach us to open a ticket.