The Home Depot Search Engine Results API

/ Home / The Home Depot Search API

Product results are the main search results. Each item contain title, brand, price, product_id. It might also contain rating, reviews, price_was, price_saving, price_from, price_to, variants, delivery. Search can be refined using filters hd_filter_tokens, ordering/sorting hd_sort and pagination nao can be used. Head to the playground for a live and interactive demo.

API Parameters

Search Query

q

Required

Parameter defines the search query. You can use anything that you would use in a regular The Home Depot search.

Pagination

nao

Optional

Defines offset for products result. A single page contains 24 products. First page offset is 0, second - 24, third - 48 and so on.

Advanced Filters

hd_sort

Optional

Have some predefined options that can be used to sort results. List of options

lowerbound

Optional

Defines lower bound for price in USD.

upperbound

Optional

Defines upper bound for price in USD.

hd_filter_tokens

Optional

Used to pass filter tokens divided by comma. Filter tokens can be obtained from API response

Serpapi Parameters

engine

Required

Set parameter to home_depot_product to use The Home Depot API engine.

no_cache

Optional

Parameter will force SerpApi to fetch The Home Depot results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together.

api_key

Optional

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

Example with q:"chair" parameter

Example with q:"chair" parameter

JSON Example

{
  "search_metadata": {
    "id": "5ea9308159603d73ac130363",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/c78c82fb5fed5f0b/5ea9308159603d73ac130363.json",
    "created_at": "2020-04-29 07:45:05 UTC",
    "processed_at": "2020-04-29 07:45:06 UTC",
    "home_depot_url": "https://www.homedepot.com/b/N-5yc1v/Ntt-chair?",
    "raw_html_file": "https://serpapi.com/searches/c78c82fb5fed5f0b/5ea9308159603d73ac130363.html",
    "total_time_taken": 8.7
  },
  "search_parameters": {
    "q": "chair",
    "engine": "home_depot"
  },
  "search_information": {
    "results_state": "Results for exact spelling",
    "query_displayed": "chair",
    "total_results": 17279
  },
  "products": [
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/c70c272d-8fb5-4df7-8c53-85642593c60f/svn/navy-blue-lifestyle-solutions-accent-chairs-lk-lgfsp1gu3051-64_400.jpg",
      "variants": [
        "https://images.homedepot-static.com/catalog/swatchImages/35/5f/5f4399ff-27e7-433c-af73-1171c8bfbcc3_35.jpg",
        "https://images.homedepot-static.com/catalog/swatchImages/35/84/84b3f85d-5109-4d07-be97-f39267503168_35.jpg"
      ],
      "title": "Lillith Mid Century Modern Chair in Navy Blue",
      "brand": "Lifestyle Solutions",
      "rating": 4.5,
      "reviews": 57,
      "badge": "Best Seller",
      "price": "$163.19",
      "link": "https://www.homedepot.com/p/Lifestyle-Solutions-Lillith-Mid-Century-Modern-Chair-in-Navy-Blue-LK-LGFSP1GU3051/304602833",
      "product_id": "304602833",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=304602833",
      "delivery": "Free delivery"
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/5f0dccb6-0056-40f8-a019-1b5fe81f23bc/svn/black-accent-chairs-02-201-06-560-64_400.jpg",
      "variants": [
        "https://images.homedepot-static.com/catalog/swatchImages/35/a2/a21b2f63-5ded-4bcf-805b-d9a79163be5a_35.jpg",
        "https://images.homedepot-static.com/catalog/swatchImages/35/d2/d2c3ba02-9bd0-4a44-8cf9-c3346eb409f2_35.jpg",
        "https://images.homedepot-static.com/catalog/swatchImages/35/b3/b3f60138-0a8f-4a15-9dec-796c22a24b80_35.jpg"
      ],
      "title": "Grant Black High Back Wingback Crackle Leather Accent Chair with Nailhead Accents",
      "rating": 4.7,
      "reviews": 3,
      "price": "$450.85",
      "link": "https://www.homedepot.com/p/Grant-Black-High-Back-Wingback-Crackle-Leather-Accent-Chair-with-Nailhead-Accents-02-201-06-560/304014033",
      "product_id": "304014033",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=304014033",
      "delivery": "Standard Delivery"
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/66523961-3ae5-40f1-acde-b04c8d9fcca0/svn/white-and-blue-noble-house-accent-chairs-11808-64_400.jpg",
      "variants": [
        "https://images.homedepot-static.com/catalog/swatchImages/35/0d/0d50b8c7-383f-4503-86ff-34359b806260_35.jpg",
        "https://images.homedepot-static.com/catalog/swatchImages/35/53/53adce66-5204-4ae8-94b9-58b478cbd3e5_35.jpg"
      ],
      "title": "Preston White and Blue Floral Fabric Low back Club Chair",
      "brand": "Noble House",
      "rating": 4.7,
      "reviews": 33,
      "price": "$190.31",
      "link": "https://www.homedepot.com/p/Noble-House-Preston-White-and-Blue-Floral-Fabric-Low-back-Club-Chair-11808/306657427",
      "product_id": "306657427",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=306657427",
      "delivery": "Standard Delivery"
    },
  ],
  "filters": {
    ...
  },
  "pagination": {
    "current": 1,
    "next": "https://www.homedepot.com/b/N-5yc1v/Ntt-chair?Nao=24",
    "other_pages": {
      "2": "https://www.homedepot.com/b/N-5yc1v/Ntt-chair?Nao=24",
      "3": "https://www.homedepot.com/b/N-5yc1v/Ntt-chair?Nao=48",
      "4": "https://www.homedepot.com/b/N-5yc1v/Ntt-chair?Nao=72",
      "5": "https://www.homedepot.com/b/N-5yc1v/Ntt-chair?Nao=96"
    }
  },
  "serpapi_pagination": {
    "current": 1,
    "next_link": "https://serpapi.com/search.json?engine=home_depot&nao=24&q=chair",
    "next": "https://serpapi.com/search.json?engine=home_depot&nao=24&q=chair",
    "other_pages": {
      "2": "https://serpapi.com/search.json?engine=home_depot&nao=24&q=chair",
      "3": "https://serpapi.com/search.json?engine=home_depot&nao=48&q=chair",
      "4": "https://serpapi.com/search.json?engine=home_depot&nao=72&q=chair",
      "5": "https://serpapi.com/search.json?engine=home_depot&nao=96&q=chair"
    }
  }
}

Example with q:"hammer", third page nao:"nao" and ordering low to high hd_sort:"price_high_to_low"

Search can be refined using filters hd_filter_tokens, ordering/sorting hd_sort and pagination nao can be used.

Example with q:"hammer", third page nao:"nao" and ordering low to high hd_sort:"price_high_to_low"

JSON Example

{
  "search_metadata": {
    "id": "5ea933bc59603d73ac130364",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/585c7b3d67acfd05/5ea933bc59603d73ac130364.json",
    "created_at": "2020-04-29 07:58:52 UTC",
    "processed_at": "2020-04-29 07:58:53 UTC",
    "home_depot_url": "https://www.homedepot.com/b/N-5yc1v/Ntt-hammer?Nao=48&sortorder=asc&sortby=price&Ns=P_REP_PRC_MODE%7C0",
    "raw_html_file": "https://serpapi.com/searches/585c7b3d67acfd05/5ea933bc59603d73ac130364.html",
    "total_time_taken": 6.64
  },
  "search_parameters": {
    "q": "hammer",
    "nao": "48",
    "hd_sort": "price_low_to_high",
    "engine": "home_depot"
  },
  "search_information": {
    "results_state": "Results for exact spelling",
    "query_displayed": "hammer",
    "total_results": 3278
  },
  "products": [
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/9274e5fd-98cc-4905-bdd2-70211f662aa4/svn/black-rust-oleum-universal-general-purpose-spray-paint-342489-64_400_compressed.jpg",
      "title": "Rust-Oleum Universal 11 oz. All Surface Hammered Black Spray Paint and Primer in One",
      "brand": "Rust-Oleum Universal",
      "rating": 4.0,
      "reviews": 870,
      "price": "$6.98",
      "link": "https://www.homedepot.com/p/Rust-Oleum-Universal-11-oz-All-Surface-Hammered-Black-Spray-Paint-and-Primer-in-One-342489/307244803",
      "product_id": "307244803",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=307244803",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/b20d1e40-b2e0-4fb0-b698-f5b557c2a366/svn/dark-bronze-rust-oleum-universal-general-purpose-spray-paint-342491-64_400_compressed.jpg",
      "title": "Rust-Oleum Universal 11 oz. All Surface Hammered Dark Bronze Spray Paint and Primer in One",
      "brand": "Rust-Oleum Universal",
      "rating": 4.0,
      "reviews": 870,
      "price": "$6.98",
      "link": "https://www.homedepot.com/p/Rust-Oleum-Universal-11-oz-All-Surface-Hammered-Dark-Bronze-Spray-Paint-and-Primer-in-One-342491/307244792",
      "product_id": "307244792",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=307244792",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/548ec5c9-3bfe-401b-8cd5-1a5833c85599/svn/a-street-wallpaper-2922-24012sam-64_400_compressed.jpg",
      "title": "A-Street Goldberg Brown Hammered Metal Wallpaper Sample",
      "brand": "A-Street",
      "price": "$7.00",
      "link": "https://www.homedepot.com/p/A-Street-Goldberg-Brown-Hammered-Metal-Wallpaper-Sample-2922-24012SAM/310533997",
      "product_id": "310533997",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=310533997",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/528597d5-e784-4871-91d9-3d387f024309/svn/a-street-wallpaper-2922-25371sam-64_400_compressed.jpg",
      "title": "A-Street Goldberg Ivory Hammered Metal Wallpaper Sample",
      "brand": "A-Street",
      "price": "$7.00",
      "link": "https://www.homedepot.com/p/A-Street-Goldberg-Ivory-Hammered-Metal-Wallpaper-Sample-2922-25371SAM/310533957",
      "product_id": "310533957",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=310533957",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/e9886b9f-dbaa-4987-9924-3df9b845bbea/svn/mng-hardware-cabinet-knobs-12813-64_400_compressed.jpg",
      "title": "MNG Hardware 1.25 in. Oil Rubbed Bronze Hammered Round Knob",
      "brand": "MNG Hardware",
      "price": "$7.01",
      "link": "https://www.homedepot.com/p/MNG-Hardware-1-25-in-Oil-Rubbed-Bronze-Hammered-Round-Knob-12813/205866460",
      "product_id": "205866460",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=205866460",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/661994a1-ffc9-4a8b-a79c-896099f9b473/svn/bon-tool-mallets-87-398-64_400_compressed.jpg",
      "title": "Bon Tool 16 oz. Thrifty White Rubber Mallet with 11 in. Wood Handle",
      "brand": "Bon Tool",
      "rating": 5.0,
      "reviews": 2,
      "price": "$7.26",
      "link": "https://www.homedepot.com/p/Bon-Tool-16-oz-Thrifty-White-Rubber-Mallet-with-11-in-Wood-Handle-87-398/303204465",
      "product_id": "303204465",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=303204465",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/4ceaa5d2-a9a5-4410-baa7-56f50402c5b2/svn/bon-tool-concrete-handles-13-396-64_400_compressed.jpg",
      "title": "New Bon Tool 13 in. Replacement Handle for Magnetic Hammer",
      "brand": "Bon Tool",
      "badge": "New",
      "price": "$7.26",
      "link": "https://www.homedepot.com/p/Bon-Tool-13-in-Replacement-Handle-for-Magnetic-Hammer-13-396/312677345",
      "product_id": "312677345",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=312677345",
    },
    ...
  ],
  "filters": {
    ...
  },
  "pagination": {
    "other_pages": {
      "1": "https://www.homedepot.com/b/N-5yc1v/Ntk-EnrichedProductInfo/Ntt-hammer?NCNI-5",
      "2": "https://www.homedepot.com/b/N-5yc1v/Ntk-EnrichedProductInfo/Ntt-hammer?NCNI-5&Nao=24&Ns=P_REP_PRC_MODE%7C0",
      "4": "https://www.homedepot.com/b/N-5yc1v/Ntk-EnrichedProductInfo/Ntt-hammer?NCNI-5&Nao=72&Ns=P_REP_PRC_MODE%7C0",
      "5": "https://www.homedepot.com/b/N-5yc1v/Ntk-EnrichedProductInfo/Ntt-hammer?NCNI-5&Nao=96&Ns=P_REP_PRC_MODE%7C0"
    },
    "previous": "https://www.homedepot.com/b/N-5yc1v/Ntk-EnrichedProductInfo/Ntt-hammer?NCNI-5&Nao=24&Ns=P_REP_PRC_MODE%7C0",
    "next": "https://www.homedepot.com/b/N-5yc1v/Ntk-EnrichedProductInfo/Ntt-hammer?NCNI-5&Nao=72&Ns=P_REP_PRC_MODE%7C0",
    "current": 3
  },
  "serpapi_pagination": {
    "current": 3,
    "previous_link": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=24&q=hammer",
    "previous": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=24&q=hammer",
    "next_link": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=72&q=hammer",
    "next": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=72&q=hammer",
    "other_pages": {
      "1": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=0&q=hammer",
      "2": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=24&q=hammer",
      "4": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=72&q=hammer",
      "5": "https://serpapi.com/search.json?engine=home_depot&hd_sort=price_low_to_high&nao=96&q=hammer"
    }
  }
}

Example with q:"hammer", and filters for brand "DEWALT" and bit material "carbid"

Search can be refined using filters hd_filter_tokens, ordering/sorting hd_sort and pagination nao can be used.

Example with q:"hammer", and filters for brand "DEWALT" and bit material "carbid"

JSON Example

{
  "search_metadata": {
    "id": "5ea933c859603d73adb50fba",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/0f3dca151992776c/5ea933c859603d73adb50fba.json",
    "created_at": "2020-04-29 07:59:04 UTC",
    "processed_at": "2020-04-29 07:59:04 UTC",
    "home_depot_url": "https://www.homedepot.com/b/N-5yc1vZ1z0wn8iZ4j2/Ntt-hammer?",
    "raw_html_file": "https://serpapi.com/searches/0f3dca151992776c/5ea933c859603d73adb50fba.html",
    "total_time_taken": 8.57
  },
  "search_parameters": {
    "q": "hammer",
    "hd_filter_tokens": "1z0wn8i,4j2",
    "engine": "home_depot"
  },
  "search_information": {
    "results_state": "Results for exact spelling",
    "query_displayed": "hammer",
    "total_results": 3
  },
  "products": [
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/92a56b98-19ea-48f1-be32-2a8fc5ac9d14/svn/dewalt-masonry-drill-bits-dw5470-64_400_compressed.jpg",
      "title": "DEWALT Rock Carbide SDS+ Hammer Bit Set (5-Piece)",
      "brand": "DEWALT",
      "rating": 3.5,
      "reviews": 4,
      "price": "$23.46",
      "link": "https://www.homedepot.com/p/DEWALT-Rock-Carbide-SDS-Hammer-Bit-Set-5-Piece-DW5470/202522836",
      "product_id": "202522836",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=202522836",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/e97edeb1-574b-46ed-bb1e-3c44b4a5da70/svn/dewalt-masonry-drill-bits-dw5402-y-64_400_compressed.jpg",
      "title": "DEWALT 3/16 in. x 4 in. Rock Carbide SDS+ Hammer Bit",
      "brand": "DEWALT",
      "rating": 3.7,
      "reviews": 3,
      "price": "$6.80",
      "link": "https://www.homedepot.com/p/DEWALT-3-16-in-x-4-in-Rock-Carbide-SDS-Hammer-Bit-DW5402-Y/202521557",
      "product_id": "202521557",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=202521557",
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/132bc622-74b1-44ae-b2a5-a9e8699eb1e3/svn/dewalt-masonry-drill-bits-dw5468-64_400_compressed.jpg",
      "title": "DEWALT 1-1/8 in. x 8 in. x 10 in. SDS Plus Rock Carbide Hammer Bit",
      "brand": "DEWALT",
      "rating": 5.0,
      "reviews": 2,
      "price": "$29.77",
      "link": "https://www.homedepot.com/p/DEWALT-1-1-8-in-x-8-in-x-10-in-SDS-Plus-Rock-Carbide-Hammer-Bit-DW5468/203299679",
      "product_id": "203299679",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=203299679",
    }
  ],
  "filters": {
    ...
  }
}