Reviews

2min

Reviews Results
When making a request with the  type  parameter set to  type=reviews  BigBox API will return all Customer Reviews for the product specified in the  item_id  or  url  parameter.
Reviews are retrieved from the customer reviews page for a single product on Home Depot.
Customer Reviews Page
﻿
An example of the JSON object returned from a Reviews request is shown below:
json
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "homedepot_url": "https://www.homedepot.com/p/317061059"
  },
  "request_parameters": {
    "type": "reviews",
    "item_id": "317061059",
    "sort_by": "most_helpful"
  },
  "reviews": [
    {
      "position": 1,
      "id": "257606120",
      "item_id": "317061059",
      "title": "Great mower",
      "body": "I always wanted a lithium powered lawn mower and this fit the bill",
      "campaign_id": "20220519_PPC_PR1_OUT_4034447_",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-19T14:27:36.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8151927",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/7604b51f-ed3b-5aeb-9432-827200805aef"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": false,
        "author_name": "IanLynPhotography",
        "author_id": "243961987",
        "author_location": "Valley Stream",
        "verified_purchase": false
      }
    },
    {
      "position": 2,
      "id": "257555766",
      "item_id": "317061059",
      "title": "After one day of use, so far so good.",
      "body": "I picked up the mower this morning at my local HD.\r\nIt assembled way easier than I expected.\r\nAnd the battery charged completely after about 30 minutes.\r\n\r\nSome minor quality things.\r\nOne:\r\nWhen I ordered the mower on the HD web site, I saw Model RY401170VNM\r\nAnd that is the model numer on the sticker affixed to the mower.\r\nBut, the manuals (booklets really) all reference model number RY401017\r\nI thought that was kinda odd.\r\n\r\nTwo:\r\nOn the front of the battery that came with the mower, there is a button that, when pressed, should illuminate  a number of green lights indicating how much charge is currently in the battery. (Charge level indicator button.)\r\nWell, nothing happens when I press my batteries Charge level indicator button.\r\nThe light DO light up when I insert the battery into the charger while it is being charged.\r\nBut not when that button is pressed.\r\nSo, for now, I have no way of telling how much charge is in the battery unless I plug it into the charger.\r\nThe Ryobi customer support rep told me I should pack up the mower and battery and take it back to HD for a replacement.\r\nThe HD online chat support person told me the same thing.\r\nI'm unsure is that is really worth it but I just wanted others to know of my experience.",
      "campaign_id": "BV_REVIEW_DISPLAY",
      "rating": 5,
      "positive_feedback": 2,
      "negative_feedback": 0,
      "date": "2022-05-17T23:20:06.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8146005",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/e5991de2-86f8-5e14-9784-151b382780f0"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": false,
        "author_name": "JustRay",
        "author_id": "9jq3gh1wmsfdaufmd437w22fo",
        "verified_purchase": false
      }
    },
    {
      "position": 3,
      "id": "257554616",
      "item_id": "317061059",
      "title": "Alot of power",
      "body": "[This review was collected as part of a promotion.] I bought this mower, my grass was incredibly high so to procrastinating. And it powered right through it didn't big down. I have .25 acres and it got the job done very quickly",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-17T22:24:52.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8145858",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/836e7cf7-9a07-5b78-9591-1b52af625d61"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Jmaggicc",
        "author_id": "9w60z3rp81e4tokgcwt7vu4ae",
        "author_location": "Waxahachie Texas",
        "verified_purchase": false
      }
    },
    {
      "position": 4,
      "id": "257537365",
      "item_id": "317061059",
      "title": "Awesome product",
      "body": "[This review was collected as part of a promotion.] I have a range of Ryobi, 10 tools atleast in love with this brand",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-17T02:16:07.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8143232",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/bb0b2296-38f9-5689-b802-a0397558506d"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Gagan19",
        "author_id": "f42tk4rc403orrpl5eb7e1sbr",
        "author_location": "Toronto",
        "verified_purchase": false
      }
    },
    {
      "position": 5,
      "id": "257521677",
      "item_id": "317061059",
      "title": "Lots of mowing power",
      "body": "[This review was collected as part of a promotion.] My work in electrification and I was very please with both the battery life and mowing power of the 40V Ryobi.",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-16T11:57:36.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8140063",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/9fb60d6f-b356-5ec8-b1ca-2e1526554abe"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "DS19192",
        "author_id": "q0jx794xmyrqqzs97xnhpbkvq",
        "author_location": "Golden CO",
        "verified_purchase": false
      }
    },
    {
      "position": 6,
      "id": "257500171",
      "item_id": "317061059",
      "title": "Buy One",
      "body": "[This review was collected as part of a promotion.] They are great!! I just a bought weed wacker and I love it!! Thank Ryobi for the garden tool.",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-15T01:20:36.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8136369",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/4c0ec901-dac3-5847-9b5c-ca5072df28bc"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Markito",
        "author_id": "q9c09lcudqmbriadr1pcxnlsj",
        "author_location": "Utah",
        "verified_purchase": false
      }
    },
    {
      "position": 7,
      "id": "257494850",
      "item_id": "317061059",
      "title": "Great for the $$$",
      "body": "[This review was collected as part of a promotion.] I really like how simple it is to start and so light. Easy storage. Easily mowed over a half acre with on bar left. My wife likes how simple to start and easily use the self propelled. Great bang for the buck! Keep up the good work Ryobi!",
      "rating": 4,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-14T19:12:50.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8135278",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/312f8436-599a-59e8-a84c-de7f568087d8"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Tjmoore1968",
        "author_id": "trv20uwpsuvrqtzkmwmj2yq2d",
        "author_location": "Mattydale, NY",
        "verified_purchase": false
      }
    },
    {
      "position": 8,
      "id": "257468638",
      "item_id": "317061059",
      "title": "Quick & easy",
      "body": "[This review was collected as part of a promotion.] Just received this yesterday. Took right out of box. Charged up battery and away we went! The grass was high but used the height knob to easily go over it! I’m a 62 yr young woman and this was manageable for me!!!",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-13T14:18:20.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8129944",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/9a765f37-8cad-5b6e-8cb5-0ef1bfb83356"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Anonymous",
        "author_id": "th54zoxuq8mkw0zpdufes7x65",
        "author_location": "New Jersey",
        "verified_purchase": false
      }
    },
    {
      "position": 9,
      "id": "257386248",
      "item_id": "317061059",
      "title": "Awesome",
      "body": "[This review was collected as part of a promotion.] Bought this lovely girl today , definitely candy wait to see her shape up my yard",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-11T16:11:19.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8121105",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/2a073dcf-4ff4-5af1-a155-572233903eba"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Chocolate rage",
        "author_id": "75hb3rbeqmgowebz22icurbx6",
        "author_location": "Indiana",
        "verified_purchase": false
      }
    },
    {
      "position": 10,
      "id": "257197890",
      "item_id": "317061059",
      "title": "Easy to use",
      "body": "[This review was collected as part of a promotion.] I am so happy with my Ryobi battery operated lawn mower. My husband loved taking care of our lawn. He recently passed and I needed something I could handle. This lawnmower is lightweight, easy to start and store. This is what my yard looks like after that first mow. My husband would be proud. Thank you",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-04T12:05:20.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8083597",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/b55c2dfe-7546-595e-887f-72a26c81f814"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Mbooth62",
        "author_id": "eyzq1f3q5l3glgxqzq0rgb8f8",
        "author_location": "Clifton Park NY",
        "verified_purchase": false
      }
    }
  ],
  "summary": {
    "rating": 4.7,
    "ratings_total": 863,
    "recommended_count": 525,
    "not_recommended_count": 26,
    "rating_breakdown": {
      "five_star": 667,
      "four_star": 139,
      "three_star": 20,
      "two_star": 12,
      "one_star": 25
    }
  },
  "product": {
    "item_id": "317061059"
  },
  "pagination": {
    "current_page": 2,
    "next_page": 3,
    "total_pages": 87,
    "total_reviews": 863
  }
}
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "homedepot_url": "https://www.homedepot.com/p/317061059"
  },
  "request_parameters": {
    "type": "reviews",
    "item_id": "317061059",
    "sort_by": "most_helpful"
  },
  "reviews": [
    {
      "position": 1,
      "id": "257606120",
      "item_id": "317061059",
      "title": "Great mower",
      "body": "I always wanted a lithium powered lawn mower and this fit the bill",
      "campaign_id": "20220519_PPC_PR1_OUT_4034447_",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-19T14:27:36.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8151927",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/7604b51f-ed3b-5aeb-9432-827200805aef"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": false,
        "author_name": "IanLynPhotography",
        "author_id": "243961987",
        "author_location": "Valley Stream",
        "verified_purchase": false
      }
    },
    {
      "position": 2,
      "id": "257555766",
      "item_id": "317061059",
      "title": "After one day of use, so far so good.",
      "body": "I picked up the mower this morning at my local HD.\r\nIt assembled way easier than I expected.\r\nAnd the battery charged completely after about 30 minutes.\r\n\r\nSome minor quality things.\r\nOne:\r\nWhen I ordered the mower on the HD web site, I saw Model RY401170VNM\r\nAnd that is the model numer on the sticker affixed to the mower.\r\nBut, the manuals (booklets really) all reference model number RY401017\r\nI thought that was kinda odd.\r\n\r\nTwo:\r\nOn the front of the battery that came with the mower, there is a button that, when pressed, should illuminate  a number of green lights indicating how much charge is currently in the battery. (Charge level indicator button.)\r\nWell, nothing happens when I press my batteries Charge level indicator button.\r\nThe light DO light up when I insert the battery into the charger while it is being charged.\r\nBut not when that button is pressed.\r\nSo, for now, I have no way of telling how much charge is in the battery unless I plug it into the charger.\r\nThe Ryobi customer support rep told me I should pack up the mower and battery and take it back to HD for a replacement.\r\nThe HD online chat support person told me the same thing.\r\nI'm unsure is that is really worth it but I just wanted others to know of my experience.",
      "campaign_id": "BV_REVIEW_DISPLAY",
      "rating": 5,
      "positive_feedback": 2,
      "negative_feedback": 0,
      "date": "2022-05-17T23:20:06.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8146005",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/e5991de2-86f8-5e14-9784-151b382780f0"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": false,
        "author_name": "JustRay",
        "author_id": "9jq3gh1wmsfdaufmd437w22fo",
        "verified_purchase": false
      }
    },
    {
      "position": 3,
      "id": "257554616",
      "item_id": "317061059",
      "title": "Alot of power",
      "body": "[This review was collected as part of a promotion.] I bought this mower, my grass was incredibly high so to procrastinating. And it powered right through it didn't big down. I have .25 acres and it got the job done very quickly",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-17T22:24:52.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8145858",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/836e7cf7-9a07-5b78-9591-1b52af625d61"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Jmaggicc",
        "author_id": "9w60z3rp81e4tokgcwt7vu4ae",
        "author_location": "Waxahachie Texas",
        "verified_purchase": false
      }
    },
    {
      "position": 4,
      "id": "257537365",
      "item_id": "317061059",
      "title": "Awesome product",
      "body": "[This review was collected as part of a promotion.] I have a range of Ryobi, 10 tools atleast in love with this brand",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-17T02:16:07.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8143232",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/bb0b2296-38f9-5689-b802-a0397558506d"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Gagan19",
        "author_id": "f42tk4rc403orrpl5eb7e1sbr",
        "author_location": "Toronto",
        "verified_purchase": false
      }
    },
    {
      "position": 5,
      "id": "257521677",
      "item_id": "317061059",
      "title": "Lots of mowing power",
      "body": "[This review was collected as part of a promotion.] My work in electrification and I was very please with both the battery life and mowing power of the 40V Ryobi.",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-16T11:57:36.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8140063",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/9fb60d6f-b356-5ec8-b1ca-2e1526554abe"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "DS19192",
        "author_id": "q0jx794xmyrqqzs97xnhpbkvq",
        "author_location": "Golden CO",
        "verified_purchase": false
      }
    },
    {
      "position": 6,
      "id": "257500171",
      "item_id": "317061059",
      "title": "Buy One",
      "body": "[This review was collected as part of a promotion.] They are great!! I just a bought weed wacker and I love it!! Thank Ryobi for the garden tool.",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-15T01:20:36.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8136369",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/4c0ec901-dac3-5847-9b5c-ca5072df28bc"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Markito",
        "author_id": "q9c09lcudqmbriadr1pcxnlsj",
        "author_location": "Utah",
        "verified_purchase": false
      }
    },
    {
      "position": 7,
      "id": "257494850",
      "item_id": "317061059",
      "title": "Great for the $$$",
      "body": "[This review was collected as part of a promotion.] I really like how simple it is to start and so light. Easy storage. Easily mowed over a half acre with on bar left. My wife likes how simple to start and easily use the self propelled. Great bang for the buck! Keep up the good work Ryobi!",
      "rating": 4,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-14T19:12:50.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8135278",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/312f8436-599a-59e8-a84c-de7f568087d8"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Tjmoore1968",
        "author_id": "trv20uwpsuvrqtzkmwmj2yq2d",
        "author_location": "Mattydale, NY",
        "verified_purchase": false
      }
    },
    {
      "position": 8,
      "id": "257468638",
      "item_id": "317061059",
      "title": "Quick & easy",
      "body": "[This review was collected as part of a promotion.] Just received this yesterday. Took right out of box. Charged up battery and away we went! The grass was high but used the height knob to easily go over it! I’m a 62 yr young woman and this was manageable for me!!!",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-13T14:18:20.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8129944",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/9a765f37-8cad-5b6e-8cb5-0ef1bfb83356"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Anonymous",
        "author_id": "th54zoxuq8mkw0zpdufes7x65",
        "author_location": "New Jersey",
        "verified_purchase": false
      }
    },
    {
      "position": 9,
      "id": "257386248",
      "item_id": "317061059",
      "title": "Awesome",
      "body": "[This review was collected as part of a promotion.] Bought this lovely girl today , definitely candy wait to see her shape up my yard",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-11T16:11:19.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8121105",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/2a073dcf-4ff4-5af1-a155-572233903eba"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Chocolate rage",
        "author_id": "75hb3rbeqmgowebz22icurbx6",
        "author_location": "Indiana",
        "verified_purchase": false
      }
    },
    {
      "position": 10,
      "id": "257197890",
      "item_id": "317061059",
      "title": "Easy to use",
      "body": "[This review was collected as part of a promotion.] I am so happy with my Ryobi battery operated lawn mower. My husband loved taking care of our lawn. He recently passed and I needed something I could handle. This lawnmower is lightweight, easy to start and store. This is what my yard looks like after that first mow. My husband would be proud. Thank you",
      "rating": 5,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "date": "2022-05-04T12:05:20.000+00:00",
      "is_recommended": true,
      "is_early_reviewer_incentive": false,
      "is_incentivized_review": false,
      "is_top_1000_contributor": false,
      "is_top_250_contributor": false,
      "images": [
        {
          "id": "8083597",
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86cnlvYmlvdXRkb29ydG9vbHM/b55c2dfe-7546-595e-887f-72a26c81f814"
        }
      ],
      "source": {
        "is_external_source": true,
        "external_source": true,
        "author_name": "Mbooth62",
        "author_id": "eyzq1f3q5l3glgxqzq0rgb8f8",
        "author_location": "Clifton Park NY",
        "verified_purchase": false
      }
    }
  ],
  "summary": {
    "rating": 4.7,
    "ratings_total": 863,
    "recommended_count": 525,
    "not_recommended_count": 26,
    "rating_breakdown": {
      "five_star": 667,
      "four_star": 139,
      "three_star": 20,
      "two_star": 12,
      "one_star": 25
    }
  },
  "product": {
    "item_id": "317061059"
  },
  "pagination": {
    "current_page": 2,
    "next_page": 3,
    "total_pages": 87,
    "total_reviews": 863
  }
}
﻿
BigBox API returns the following properties for Reviews requests:
Property
Type
Description
reviews 

array 

An array of Review objects, containing each of the Customer Reviews shown on the Customer Reviews page. The Review object has the following properties:
id 
string 
The unique, Home Depot-assigned, ID of the customer review. This can be used by your app to flag whether you have previously processed this review on a prior request.
﻿
title 
string 
The title of the review.
﻿
body 
string 
The body text of the review.
﻿
item_id 
string 
The Item ID of the product the review relates to, if shown..
﻿
campaign_id 
string 
The campaign ID of the review, if shown..
﻿
date 
string 
The date of the review.
﻿
rating 
number 
The rating, out of 5, given by the reviewer.
﻿
positive_feedback 
number 
The number of times this review has been given positive feedback.
﻿
negative_feedback 
number 
The number of times this review has been given negative feedback.
﻿
is_recommended 
boolean 
Set to  true  if the review is marked as 'recommended'.
﻿
is_early_reviewer_incentive 
boolean 
Set to  true  if the review is marked as an 'early reviewer incentivized review'.
﻿
is_incentivized_review 
boolean 
Set to  true  if the review is marked as an 'incentivized review'.
﻿
is_top_1000_contributor 
boolean 
Set to  true  if the review author is marked as a 'top 1000 contributor'.
﻿
is_top_250_contributor 
boolean 
Set to  true  if the review author is marked as a 'top 250 contributor'.
﻿
is_top_250_contributor 
boolean 
Set to  true  if the review author is marked as a 'top 250 contributor'.
﻿
images 
array 
An array of image objects containing the reviewer-supplied images accompanying the review. Each item in the array contains an  id  and  link  property.
﻿
videos 
array 
An array of video objects containing the reviewer-supplied videos accompanying the review. Each item in the array contains an  id ,  thumbnail  and link  property.
﻿
source 
object 
Review Source Object 
The  source  object contains details about the source and author of the review.
﻿
is_external_source 
boolean 
True/false whether the review was sourced from an external third-party.
﻿
author_name 
string 
The username of the author of the review.
﻿
author_id 
string 
The ID of the author of the review.
﻿
author_location 
string 
The location of the author of the review, if shown.
﻿
verified_purchase 
boolean 
Whether this reviewer is an verified purchaser of the product.
product 

object 

An object containing details of the product (in so far as those details are shown on the Customer Reviews page). For full product details you should issue a request with  type=product  to retrieve details from the product page.
item_id 
string 
The Item ID of the product the reviews relate to.
summary 

object 

An object containing a summary of all reviews for the product, as shown at the top-left of the Customer Reviews page.
rating  
number 
The overall rating of the product, out of 5.
﻿
ratings_total 
number 
The total number of customer ratings the product has received.
﻿
recommended_count 
number 
The number of reviews that recommend the product (all reviews, not just those on the current page).
﻿
not_recommended_count 
number 
The number of reviews that do not recommend the product (all reviews, not just those on the current page).
﻿
rating_breakdown 
object 
Rating Breakdown Object 
Contains details how many of each star rating value the product has received.
﻿
one_star 
number 
The number of one-star ratings received.
﻿
two_star 
number 
The number of two-star ratings received.
﻿
three_star 
number 
The number of three-star ratings received.
﻿
four_star 
number
The number of four-star ratings received.
﻿
five_star  
number 
The number of five-star ratings received.
pagination 

object 

Pagination Object 
An object containing details of the current page and the total number of pages that are available. To paginate you should specify the page number in your request's  page  parameter.
current_page 
number 
The current page number.
﻿
next_page 
number 
The next page number, if a next page of results is available.
﻿
total_pages
number 
The total number of pages of results.
﻿
Next Steps
     Reviews Parameters﻿

Property	Type	Description
reviews	array	An array of Review objects, containing each of the Customer Reviews shown on the Customer Reviews page. The Review object has the following properties: id string The unique, Home Depot-assigned, ID of the customer review. This can be used by your app to flag whether you have previously processed this review on a prior request. title string The title of the review. body string The body text of the review. item_id string The Item ID of the product the review relates to, if shown.. campaign_id string The campaign ID of the review, if shown.. date string The date of the review. rating number The rating, out of 5, given by the reviewer. positive_feedback number The number of times this review has been given positive feedback. negative_feedback number The number of times this review has been given negative feedback. is_recommended boolean Set to true if the review is marked as 'recommended'. is_early_reviewer_incentive boolean Set to true if the review is marked as an 'early reviewer incentivized review'. is_incentivized_review boolean Set to true if the review is marked as an 'incentivized review'. is_top_1000_contributor boolean Set to true if the review author is marked as a 'top 1000 contributor'. is_top_250_contributor boolean Set to true if the review author is marked as a 'top 250 contributor'. is_top_250_contributor boolean Set to true if the review author is marked as a 'top 250 contributor'. images array An array of image objects containing the reviewer-supplied images accompanying the review. Each item in the array contains an id and link property. videos array An array of video objects containing the reviewer-supplied videos accompanying the review. Each item in the array contains an id , thumbnail and link property. source object Review Source Object The source object contains details about the source and author of the review. is_external_source boolean True/false whether the review was sourced from an external third-party. author_name string The username of the author of the review. author_id string The ID of the author of the review. author_location string The location of the author of the review, if shown. verified_purchase boolean Whether this reviewer is an verified purchaser of the product.
product	object	An object containing details of the product (in so far as those details are shown on the Customer Reviews page). For full product details you should issue a request with type=product to retrieve details from the product page. item_id string The Item ID of the product the reviews relate to.
summary	object	An object containing a summary of all reviews for the product, as shown at the top-left of the Customer Reviews page. rating number The overall rating of the product, out of 5. ratings_total number The total number of customer ratings the product has received. recommended_count number The number of reviews that recommend the product (all reviews, not just those on the current page). not_recommended_count number The number of reviews that do not recommend the product (all reviews, not just those on the current page). rating_breakdown object Rating Breakdown Object Contains details how many of each star rating value the product has received. one_star number The number of one-star ratings received. two_star number The number of two-star ratings received. three_star number The number of three-star ratings received. four_star number The number of four-star ratings received. five_star number The number of five-star ratings received.
pagination	object	Pagination Object An object containing details of the current page and the total number of pages that are available. To paginate you should specify the page number in your request's page parameter. current_page number The current page number. next_page number The next page number, if a next page of results is available. total_pages number The total number of pages of results.

Updated 05 Aug 2024

Did this page help you?

Product

Questions