> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/home-depot/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/home-depot/search.mdx>

---

# Home Depot Search API

Search the Home Depot catalogue by keyword, 12 products a page, in the orders the site offers.

`GET /v1/home-depot/search?query=cordless%20drill` returns `data.products`, each with `id`, `url`, `name`, `brand`, `modelNumber`, `storeSku`, `imageUrl`, `price`, `rating`, `reviewCount`, `badges`, `categories`, `availability` (stock: `IN_STOCK`, `LIMITED_STOCK`, `BACKORDERED` or `OUT_OF_STOCK`), `channel` and `isSponsored`, plus `data.totalResults`, `data.correctedQuery` when the site searched other words, and `data.categories` when the search landed on one category.

Sort with `sort` (`best_match`, `top_sellers`, `price_low_to_high`, `price_high_to_low`, `top_rated`) and keep requesting with `page.nextCursor` while `page.hasMore` is true. A search with no match is `found` with no products. Pass a product's `id` to `/v1/home-depot/product` for its full details.

## Request

- **Endpoint:** `GET /v1/home-depot/search`
- **Credits:** 3 credits
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by keyword
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/home-depot/search/get)
- **Platform page:** [/platforms/home-depot](https://www.socialfetch.dev/platforms/home-depot)

## FAQ

### How many results can I page through?

12 products a page, up to 360 for one search, as deep as the site pages. When more match than the site will page through, the last page has page.truncated: true and totalResults shows the full count.

### Are sponsored products included?

Yes, where the site shows them, with isSponsored: true, so you can keep or drop them.

### What if the site corrects my spelling?

The results are for the corrected words, and correctedQuery holds them. query always holds the words you sent.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
