Logo SearchApi

Home Depot Reviews API Documentation

GET   /api/v1/search?engine=home_depot_reviews
OpenAPI Initiative Download OpenAPI Spec

The Home Depot Reviews API returns customer reviews for a Home Depot product, with ratings, review text, photos, brand replies and the product's rating summary. You can sort the reviews and filter them by star rating, verified purchase or text.

By default, Home Depot also returns reviews written for the product's other versions, such as a kit and the tool-only item. Each review's product names the version it was written for, and is_family_excluded=true returns only reviews of the product itself.

The product summary is left out when rating, is_verified_purchase or q narrows the reviews, because Home Depot's summary then covers only the matching reviews. Home Depot only returns pages that start within its first 501 reviews, so pagination stops at page 17 at 30 reviews per page.

API Parameters

Search Query

  • Name
    product_id
    Required
    Required
    Description

    Parameter defines the Home Depot product ID to get reviews for. It is the 9-digit number at the end of a product page URL, such as 320326875.

Review Filters

  • Name
    rating
    Required
    Optional
    Description

    Parameter filters reviews by star rating. Supported values are 1, 2, 3, 4, and 5, comma-separated for several, such as 1,2. The response then has no product summary.

  • Name
    is_verified_purchase
    Required
    Optional
    Description

    Set this parameter to true to return only reviews from verified purchases. The response then has no product summary.

  • Name
    q
    Required
    Optional
    Description

    Parameter defines text to search for in the reviews, such as battery. It can be up to 128 characters long, and an emoji counts as two. It cannot contain & or +, and it must contain a letter or a digit. The response then has no product summary.

  • Name
    is_family_excluded
    Required
    Optional
    Description

    Set this parameter to true to return only reviews written for this product. By default, Home Depot also returns reviews of the product's other versions, such as a kit and the tool-only item. Each review's product names the version it was written for.

Sorting

  • Name
    sort_by
    Required
    Optional
    Description

    Parameter defines the order of the reviews. Supported values:

    • photo_reviewsDefault
    • most_helpful
    • newest
    • oldest
    • highest_rating
    • lowest_rating
    photo_reviews lists reviews with photos first, as homedepot.com does.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Parameter defines the page number of results. Home Depot only returns pages that start within its first 501 reviews, so the last page is 17 at 30 reviews per page.

  • Name
    num
    Required
    Optional
    Description

    Parameter defines the number of reviews per page. It can be from 1 to 100.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to home_depot_reviews.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=home_depot_reviews&product_id=320326875
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "home_depot_reviews",
  "product_id": "320326875"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_Prwe0yhxZ1LlOTTGRpmu5nfN",
    "status": "Success",
    "created_at": "2026-11-11T10:44:53Z",
    "request_time_taken": 3.14,
    "parsing_time_taken": 0.0,
    "total_time_taken": 3.14,
    "request_url": "https://www.homedepot.com/p/reviews/x/320326875/1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Prwe0yhxZ1LlOTTGRpmu5nfN.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Prwe0yhxZ1LlOTTGRpmu5nfN"
  },
  "search_parameters": {
    "engine": "home_depot_reviews",
    "product_id": "320326875"
  },
  "search_information": {
    "total_results": 2501
  },
  "product": {
    "product_id": "320326875",
    "rating": 4.6961,
    "reviews": 2501,
    "reviews_histogram": {
      "1": 107,
      "2": 30,
      "3": 34,
      "4": 174,
      "5": 2156
    },
    "recommended_percentage": 91
  },
  "reviews": [
    {
      "position": 1,
      "id": "415984750",
      "title": "AMAZING N.B.S",
      "text": "I ABSOLUTELY LOVE IT, if you can get this at the discounted price do it. I have used it every single day or at least one tool if not more multiple times. Absolutely love it all the projects around my house are getting done",
      "rating": 5,
      "iso_date": "2026-10-25T04:35:28Z",
      "user": {
        "id": "zb9k79z3wm9l76ckn48ajlblj6",
        "name": "thisguy726",
        "location": "Wisconsin"
      },
      "is_recommended": true,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86bWlsd2F1a2VldG9vbA/3527071d-d605-5064-b469-c300ab16503d",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86bWlsd2F1a2VldG9vbA/b7ddcfaf-2e40-514f-a6ed-57c0b130183d"
        },
        "..."
      ],
      "source": "milwaukeetool.com",
      "product": {
        "product_id": "320326875",
        "title": "M18 FUEL™ 5-Tool Combo Kit"
      }
    },
    {
      "position": 2,
      "id": "307662934",
      "text": "Gen 3 on left vs new gen 4 on right. I upgraded to the new Gen 4 and I like. The gen 3 did great for me and never had an issue with it. The new one is lighter, more compact and more power! Trigger control is nicer. I especially like the tri led light up front vs single light on old one. The gen 3rd did have a bit holder opposite side of belt clip. The new one does not. Not a deal breaker but I did try to switch bit holder from old one to new one. It screws on but doesn’t fully seat properly so it’s not 100% compatible without doing some modifications to bit holder. They do make bit holders you can purchase for the new gen 4 if you have to have one. But it was nice that the gen 3 already came with one. Besides that gen 4 is better in every single way!",
      "rating": 5,
      "iso_date": "2026-10-22T07:31:00Z",
      "user": {
        "id": "0522930B82866FC40S",
        "name": "HomeDepotCustomer"
      },
      "is_verified_purchase": true,
      "badges": [
        "earlyReviewerIncentive",
        "verifiedPurchaser"
      ],
      "positive_feedback": 0,
      "negative_feedback": 0,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/81db6453-04a3-5aae-9517-0afa69d56ed4",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/8968af12-cb5b-56ed-8b3b-bdcf04e294e8"
        },
        "..."
      ],
      "product": {
        "product_id": "320326875",
        "title": "M18 FUEL 18V Lithium-Ion Brushless Cordless 1/4 in. Hex Impact Driver (Tool-Only)"
      }
    },
    {
      "position": 10,
      "id": "306000223",
      "title": "I can’t believe Milwaukee cheated on me. We got divorced.",
      "text": "Been doing this work since 1972. Milwaukee used to be someone you could trust. Just returned my brand new impact driver after less than a week’s work. I have a thousands of dollars worth of Milwaukee tools and batteries, but at this time I am at a crossroads; I hate to say it but it is time to part ways and cut my losses. Goodbye old friend, you were a trustworthy friend, now you have stabbed me in the back and are dead to me, so sorry to say. Can’t believe I’m saying that.",
      "rating": 1,
      "iso_date": "2026-08-24T17:44:40Z",
      "user": {
        "id": "zda7djyg6d9246yuslts2qdflu",
        "name": "MC Hammer",
        "location": "PNW"
      },
      "positive_feedback": 0,
      "negative_feedback": 0,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/64a380da-c81c-5350-aca4-964c3121cb21",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/92254421-4e2d-57d8-abcb-5f32b60a4901"
        },
        "..."
      ],
      "secondary_ratings": [
        {
          "name": "Quality",
          "rating": 1
        },
        "..."
      ],
      "response": {
        "text": "We appreciate your feedback on your M18 FUEL 18V Lithium-Ion Brushless Cordless 1/4 in. Hex Impact Driver (Tool-Only), and we will be sure to pass it along to our team. If you have any additional feedback, please reach out to us at social.media@milwaukeetool.com. Thank you! - Milwaukee Tool Social Team",
        "iso_date": "2026-08-27T21:16:02Z",
        "user": {
          "name": "Milwaukee Tool"
        }
      },
      "product": {
        "product_id": "320326875",
        "title": "M18 FUEL 18V Lithium-Ion Brushless Cordless 1/4 in. Hex Impact Driver (Tool-Only)"
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.homedepot.com/p/reviews/x/320326875/2",
    "total_pages": 17
  }
}

Rating Filter and Sorting

Rating Filter and Sorting
GET
https://www.searchapi.io/api/v1/search?engine=home_depot_reviews&product_id=320326875&rating=1%2C2&sort_by=newest
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "home_depot_reviews",
  "product_id": "320326875",
  "rating": "1,2",
  "sort_by": "newest"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_663mjcjdTDXKtRjnR9I4M3Sx",
    "status": "Success",
    "created_at": "2026-11-11T18:30:12Z",
    "request_time_taken": 1.74,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.74,
    "request_url": "https://www.homedepot.com/p/reviews/x/320326875/1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_663mjcjdTDXKtRjnR9I4M3Sx.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_663mjcjdTDXKtRjnR9I4M3Sx"
  },
  "search_parameters": {
    "engine": "home_depot_reviews",
    "product_id": "320326875",
    "sort_by": "newest",
    "rating": "1,2"
  },
  "search_information": {
    "total_results": 104
  },
  "reviews": [
    {
      "position": 1,
      "id": "307975203",
      "title": "Delivery date isn't accurate",
      "text": "Don't believe delivery dates! It was supposed to arrive 2 days ago and still hasn't shipped! Now, they say it'll be here in 2 more days!",
      "rating": 1,
      "iso_date": "2026-11-02T22:51:26Z",
      "user": {
        "id": "za99xaq7si7x12y3np7c4ltsus",
        "name": "Whodat",
        "location": "Katy, Texas"
      },
      "positive_feedback": 0,
      "negative_feedback": 0,
      "product": {
        "product_id": "325480442",
        "title": "M18 18-Volt Lithium-Ion Compact Brushless Cordless 1/4 in. Impact Driver Kit with One 2.0 Ah Battery, Charger & Tool Bag"
      }
    },
    {
      "position": 2,
      "id": "307189161",
      "text": "No battery’s included",
      "rating": 1,
      "iso_date": "2026-10-06T09:43:02Z",
      "user": {
        "id": "349688648",
        "name": "DAVID"
      },
      "is_verified_purchase": true,
      "badges": [
        "verifiedPurchaser"
      ],
      "positive_feedback": 0,
      "negative_feedback": 0,
      "product": {
        "product_id": "320326875",
        "title": "M18 FUEL 18V Lithium-Ion Brushless Cordless 1/4 in. Hex Impact Driver (Tool-Only)"
      }
    },
    {
      "position": 6,
      "id": "306000223",
      "title": "I can’t believe Milwaukee cheated on me. We got divorced.",
      "text": "Been doing this work since 1972. Milwaukee used to be someone you could trust. Just returned my brand new impact driver after less than a week’s work. I have a thousands of dollars worth of Milwaukee tools and batteries, but at this time I am at a crossroads; I hate to say it but it is time to part ways and cut my losses. Goodbye old friend, you were a trustworthy friend, now you have stabbed me in the back and are dead to me, so sorry to say. Can’t believe I’m saying that.",
      "rating": 1,
      "iso_date": "2026-08-24T17:44:40Z",
      "user": {
        "id": "zda7djyg6d9246yuslts2qdflu",
        "name": "MC Hammer",
        "location": "PNW"
      },
      "positive_feedback": 0,
      "negative_feedback": 0,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/64a380da-c81c-5350-aca4-964c3121cb21",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/92254421-4e2d-57d8-abcb-5f32b60a4901"
        },
        "..."
      ],
      "secondary_ratings": [
        {
          "name": "Quality",
          "rating": 1
        },
        "..."
      ],
      "response": {
        "text": "We appreciate your feedback on your M18 FUEL 18V Lithium-Ion Brushless Cordless 1/4 in. Hex Impact Driver (Tool-Only), and we will be sure to pass it along to our team. If you have any additional feedback, please reach out to us at social.media@milwaukeetool.com. Thank you! - Milwaukee Tool Social Team",
        "iso_date": "2026-08-27T21:16:02Z",
        "user": {
          "name": "Milwaukee Tool"
        }
      },
      "product": {
        "product_id": "320326875",
        "title": "M18 FUEL 18V Lithium-Ion Brushless Cordless 1/4 in. Hex Impact Driver (Tool-Only)"
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "total_pages": 4
  }
}

Search Within Reviews

Search Within Reviews
GET
https://www.searchapi.io/api/v1/search?engine=home_depot_reviews&product_id=316629766&q=battery
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "home_depot_reviews",
  "product_id": "316629766",
  "q": "battery"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_lKvrYEGsBv1hzliQAEh02CmV",
    "status": "Success",
    "created_at": "2026-11-11T18:30:19Z",
    "request_time_taken": 6.06,
    "parsing_time_taken": 0.0,
    "total_time_taken": 6.07,
    "request_url": "https://www.homedepot.com/p/reviews/x/316629766/1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_lKvrYEGsBv1hzliQAEh02CmV.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_lKvrYEGsBv1hzliQAEh02CmV"
  },
  "search_parameters": {
    "engine": "home_depot_reviews",
    "product_id": "316629766",
    "q": "battery"
  },
  "search_information": {
    "total_results": 445
  },
  "reviews": [
    {
      "position": 1,
      "id": "305229856",
      "title": "Not the charger pictured",
      "text": "This review is not about the drill itself, which is like a dewalt products a great tool. My problem is with the charger received. The product pictured has a completely different charger for the battery. What I received was the cheapest possible charger that dewalt offer. See pictures. Bordering on false advertising. Do better Dewalt.",
      "rating": 3,
      "iso_date": "2026-08-04T17:39:38Z",
      "user": {
        "id": "zp8i3602rn4gk4bjdt1zso97ys",
        "name": "TexMexLCDR",
        "location": "South Florida"
      },
      "positive_feedback": 0,
      "negative_feedback": 0,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/45123c6b-445b-51fe-87dc-96458009aa59",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/5b8d94b4-1d66-5b29-a42e-9f4f46489630"
        },
        "..."
      ],
      "secondary_ratings": [
        {
          "name": "Quality",
          "rating": 5
        },
        "..."
      ],
      "response": {
        "text": "Hello, I appreciate your feedback on the DCF850P1 and we're sorry to hear about the charger included was incorrect. Please contact support at WECARE@sbdinc.com and reference ticket 16333929 so we have all the information available from your review. Thanks, Deeris DEWALT",
        "iso_date": "2026-10-07T16:45:45Z",
        "user": {
          "name": "DewaltProductExpert"
        }
      },
      "product": {
        "product_id": "316629766",
        "title": "ATOMIC 20V MAX Lithium-Ion Cordless 1/4 in. Brushless Impact Driver Kit, 5 Ah Battery, Charger, and Bag"
      }
    },
    {
      "position": 12,
      "id": "243744267",
      "title": "Atomic 20v 1/4\" impact packs a punch!",
      "text": "[This review was collected as part of a promotion.] So I finally am replacing my old DeWalt 1/4 impact driver. This driver did not disappoint it's smaller lighter and came with a bigger battery! This atomic compact series packs a big punch I was hesitant to replace my old faithful impact but I am amazed with the quality DeWalt continues to produce in smaller package!  Feels great in your hands and I liked that it came with the 5ah battery.",
      "rating": 5,
      "iso_date": "2023-01-03T15:08:14Z",
      "user": {
        "id": "39c5eb",
        "name": "fernie619",
        "location": "San Diego, CA"
      },
      "is_recommended": true,
      "positive_feedback": 0,
      "negative_feedback": 0,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86ZGV3YWx0/d2740801-839c-5d6c-a5ad-ae25867aeea0",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86ZGV3YWx0/fede78de-10d1-55f5-8c51-e60afb7f0aac"
        },
        "..."
      ],
      "source": "dewalt.com",
      "product": {
        "product_id": "316629766",
        "title": "20V MAX* ATOMIC™ Brushless Cordless 3-Speed 1/4-in Impact Driver Kit"
      }
    },
    {
      "position": 25,
      "id": "204056338",
      "title": "This was a necessary purchase while doing disaster relief in Puerto Rico. Having the ability to p...",
      "text": "This was a necessary purchase while doing disaster relief in Puerto Rico. Having the ability to preview the store inventory and therefore not face travel woes with the battery was nice. One battery this size lasts for a long time either in my circular saw or reciprocating saw. Thank you DW!!\r\nDave",
      "rating": 5,
      "iso_date": "2018-02-20T15:13:44Z",
      "user": {
        "id": "0300EF33F124DC8EDS",
        "name": "DREW"
      },
      "is_verified_purchase": true,
      "is_recommended": true,
      "badges": [
        "verifiedPurchaser"
      ],
      "positive_feedback": 17,
      "negative_feedback": 2,
      "images": [
        {
          "link": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/897f706e-3537-55d9-a176-835d0f2792c9",
          "thumbnail": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86aG9tZWRlcG90/ae6d8e4e-fac3-5209-a1d6-aaa3f70220c7"
        }
      ],
      "product": {
        "product_id": "205227130",
        "title": "20V MAX Premium Lithium-Ion 5.0Ah Battery Pack"
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "total_pages": 15
  }
}