The Home Depot Search API Filtering

API returns filters which can be used to refine a search. Let's start with a search for table and than use filter tokens in the next search below.

API Examples

Results for: table

Results for: table

JSON Example

{
  "filters": {
    "brand": [
      {
        "name": "StyleWell",
        "value": "n4x"
      },
      {
        "name": "Lifetime",
        "value": "42x"
      },
      {
        "name": "International Concepts",
        "value": "cws"
      },
      ...
    ],
    ...
    "product_depth_in": [
      {
        "name": "Less than 5",
        "value": "2bcudr"
      },
      {
        "name": "10 - 15",
        "value": "2bcudt"
      },
      {
        "name": "15 - 20",
        "value": "2bcudu"
      },
      ...
    ],
    "product_width_in": [
      {
        "name": "15 - 20",
        "value": "2bcue0"
      },
      {
        "name": "Less than 15 in.",
        "value": "1z1bdoe"
      },
      {
        "name": "20 - 25",
        "value": "2bcud1"
      },
      ...
    ],
    ...
  }
}

Example results for q: table and hd_filter_tokens: cws,2bcue1

Using the filtering tokens from previous we can refine search to brand "International Concepts" cws and product width "25 - 30" 2bcue1. All tokens should be separated by comma.
Example results for q: table and hd_filter_tokens: cws,2bcue1

JSON Example

{
  "products": [
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/e696fa53-1f8e-403b-9431-0d9d84d461ec/svn/unfinished-wood-international-concepts-chest-of-drawers-bd-8005-64_400.jpg",
      "title": "Brooklyn 5-Drawer Unfinished Wood Chest",
      "brand": "International Concepts",
      "rating": 3.8,
      "reviews": 17,
      "price": "$333.81",
      "link": "https://www.homedepot.com/p/International-Concepts-Brooklyn-5-Drawer-Unfinished-Wood-Chest-BD-8005/205977944",
      "product_id": "205977944",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=205977944",
      "delivery": "Free delivery"
    },
    {
      "thumbnail": "https://images.homedepot-static.com/productImages/82a71e52-242b-49a5-93d4-ba0816219cce/svn/unfinished-international-concepts-tv-stands-tv-28-64_400.jpg",
      "title": "Unfinished Storage Entertainment Center",
      "brand": "International Concepts",
      "rating": 4.3,
      "reviews": 4,
      "price": "$113.03",
      "link": "https://www.homedepot.com/p/International-Concepts-Unfinished-Storage-Entertainment-Center-TV-28/204735801",
      "product_id": "204735801",
      "serpapi_link": "https://serpapi.com/search.json?engine=home_depot_product&product_id=204735801",
      "delivery": "Free delivery"
    }
  ],
  "filters": {
    "availability": [
      {
        "name": "In Stock Only",
        "value": "bwo5s"
      }
    ],
    "color": [
      {
        "name": "Multi-Colored",
        "value": "1z0u7jh"
      }
    ],
    "brand": [
      {
        "name": "International Concepts",
        "value": "cws"
      },
      {
        "name": "Safavieh",
        "value": "4kx"
      },
      {
        "name": "Winsome Wood",
        "value": "251"
      },
      ...
    ],
    ...
  }
}