# Home Depot search: `POST /v1/homedepot/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/homedepot-search

One page of Home Depot products for a `query` or a `category`.

Each row has the `item_id` (feed it to `/v1/homedepot/product` or
`/v1/homedepot/stock`), title, brand, model, store SKU, link, price,
was-price, discount, clearance price, special-buy flag, rating, review
count, image, and whether pickup and delivery are offered. Give
`store_id` for that store's prices. A search Home Depot sends to a
category is followed there (`search_information.redirected_to`). An empty
page is not billed; a failed call is 503 with
`Retry-After` and is not billed.

Request body (JSON):

- `query` (string | null; optional; min length 1, max length 120): What to search for, as typed in Home Depot's search box: 'cordless drill', 'hammer', '2x4 lumber'.
- `category` (string | null; optional; max length 500): A Home Depot category link (https://www.homedepot.com/b/Appliances-Refrigerators/N-5yc1vZc3pi) or its N- code.
- `store_id` (string | null; optional; pattern ^\d{1,4}$): Home Depot store number for store prices (from POST /v1/homedepot/stores), e.g. '6175'.
- `zip_code` (string | null; optional; pattern ^\d{5}(?:-\d{4})?$): US ZIP code for delivery availability, e.g. '10001'.
- `page` (integer; optional; default 1; min 1, max 84): Result page.
- `page_size` (integer; optional; default 24; min 1, max 48): Products per page (1-48).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
