Home Depot APIhomedepot.com ↗
Access Home Depot product search, pricing, availability, fulfillment options, and store details via 5 structured API endpoints.
What is the Home Depot API?
The Home Depot API exposes 5 endpoints covering product search, detailed product data, store lookup, and fulfillment availability. Starting with search_products, you can query the Home Depot catalog by keyword and retrieve up to 24 results per call including item IDs, pricing, and media. Dedicated endpoints then let you drill into individual product details, check in-store and delivery availability, and locate stores by ZIP code or store ID.
curl -X GET 'https://api.parse.bot/scraper/b3317837-d71f-4e52-af50-9d93fb84f2eb/search_products?limit=5&query=drill&store_id=6932&page_size=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace homedepot-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Home Depot SDK — search products, drill into details, find stores."""
from parse_apis.Home_Depot_API import HomeDepot, ProductNotFound
hd = HomeDepot()
# Search for cordless drills — limit caps total items fetched
for product in hd.products.search(query="cordless drill", limit=3):
print(product.product_label, product.brand_name, product.price_value)
# Drill down: get full details for the first search result
result = hd.products.search(query="hammer", limit=1).first()
if result:
full = result.details()
print(full.product_label, full.description, full.availability_type)
# Check availability on that product
avail = full.availability()
print(avail.buyable, avail.discontinued, avail.price_value)
# Find a store by ZIP code
store = hd.stores.find(zip_code="30339")
print(store.name, store.phone, store.city, store.state)
# Get store details by ID
try:
store_detail = hd.stores.get(store_id="6932")
print(store_detail.name, store_detail.street, store_detail.postal_code)
except ProductNotFound as exc:
print(f"Store not found: {exc}")
print("exercised: products.search / details / availability / stores.find / stores.get")
Search for products by keyword on Home Depot. Returns a list of products with identifiers, media, and pricing extracted from the search results page. Results are limited to the first page (up to 24 by default).
| Param | Type | Description |
|---|---|---|
| limit | integer | Max products to return (applied client-side to trim results) |
| queryrequired | string | Search term (e.g. 'drill', 'hammer', 'power tools') |
| store_id | string | Store ID for local pricing |
{
"type": "object",
"fields": {
"products": "array of product objects with itemId, identifiers, media, and pricing",
"searchReport": "object with totalProducts count and keyword"
},
"sample": {
"data": {
"products": [
{
"media": {
"images": [
{
"url": "https://images.thdstatic.com/productImages/4bc923ed-c482-4f8a-85d1-3b46eca358ea/svn/ryobi-power-drills-pcl201k1-64_<SIZE>.jpg",
"sizes": [
"65",
"100",
"145",
"300",
"400",
"600",
"1000"
]
}
]
},
"itemId": "326680222",
"pricing": {
"value": 49.97,
"original": 49.97
},
"identifiers": {
"brandName": "RYOBI",
"modelNumber": "PCL201K1",
"canonicalUrl": "/p/RYOBI-ONE-18V-Cordless-3-8-in-Drill-Driver-Kit-with-Compact-Battery-and-Charger-PCL201K1/326680222",
"productLabel": "ONE+ 18V Cordless 3/8 in. Drill/Driver Kit with Compact Battery and Charger"
}
}
],
"searchReport": {
"keyword": "drill",
"totalProducts": 4787
}
},
"status": "success"
}
}About the Home Depot API
Product Search and Details
The search_products endpoint accepts a query string (e.g. 'drill' or 'power tools') and an optional store_id for localized pricing. It returns an array of product objects — each with itemId, identifiers, media, and pricing — alongside a searchReport object containing totalProducts and the matched keyword. Results are capped at the first page (up to 24 items); the optional limit parameter trims that set client-side but does not paginate deeper.
For a specific item, get_product_details takes an item_id (the product's internet number, e.g. '204279858') and returns a richer payload: a details object with description and a highlights array, a pricing object including value, original, alternatePriceDisplay, and specialBuy flags, identifiers with canonicalUrl, brandName, modelNumber, and storeSkuNumber, and an availabilityType object indicating the fulfillment category. Passing store_id adjusts pricing to a specific location.
Availability and Fulfillment
get_product_availability accepts an item_id and optional store_id and returns structured fulfillment data: the availability object distinguishes between pickup and delivery options and lists their respective service configurations. The pricing object here includes both current value and original price, making it useful for change-detection workflows without re-fetching full product details.
Store Lookup
Two endpoints cover store data. find_stores resolves a 5-digit US ZIP code to the nearest Home Depot location, returning a localStore object with storeId, name, coordinates, phone, address, storeHours, and a services list. get_store_details takes a known store_id directly and returns the same structure, which is useful when you already have a store ID from a product or availability response and want to present full location information.
The Home Depot API is a managed, monitored endpoint for homedepot.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when homedepot.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official homedepot.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price changes on specific Home Depot products using
get_product_detailspricing fields over time - Build a store locator feature by resolving user ZIP codes via
find_storesand displaying hours and services - Compare in-store pickup vs. delivery availability for a product across multiple stores using
get_product_availability - Aggregate product catalog data by keyword using
search_productsto analyze category coverage or SKU counts - Display localized pricing for regional e-commerce tools by passing
store_idtoget_product_details - Validate model numbers and canonical URLs for products by extracting
identifiersfromget_product_details - Surface special-buy flags and alternate price displays for deal-tracking applications using the
pricingresponse fields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Home Depot have an official developer API?+
What does `get_product_availability` return beyond a simple in-stock flag?+
availability object that breaks down fulfillment into distinct types — pickup and delivery — each with their own service options. The response also includes current and original pricing, so you can detect discounts at the same time as checking stock status.Does `search_products` support pagination beyond the first page of results?+
searchReport field provides a totalProducts count so you can see how many results exist, but fetching subsequent pages is not currently supported. You can fork this API on Parse and revise it to add an offset or page parameter to cover additional result pages.Does the API return customer reviews or ratings for products?+
get_product_details endpoint covers descriptions, highlights, pricing, and availability type, but does not include review counts or star ratings. You can fork this API on Parse and revise it to add a reviews endpoint for that data.What is the `store_id` parameter and how do I get one?+
store_id is a numeric string identifier for a specific Home Depot location (e.g. '6932'). You can obtain it by calling find_stores with a ZIP code — the localStore.storeId field in that response can then be passed to search_products, get_product_details, or get_product_availability to return location-specific pricing and availability.