# Home Depot store stock: `POST /v1/homedepot/stock`

Cost: 3 credits (3 (an unknown item or ZIP and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/homedepot-stock

One product checked in the nearest stores to a ZIP code.

For each store (nearest first, up to `max_stores`): its id, name, city,
phone and distance, the store's price and clearance price, and whether
the shelf has it with the quantity Home Depot shows for in-store pickup
(`sold_in_store` is false where the store does not carry it). A summary
counts stores in stock and total units. An unknown item or ZIP is a 404
and is not billed; no store in range is an empty answer, not billed.

Request body (JSON):

- `item_id` (string | null; optional; pattern ^\d{9}$): The 9-digit item id.
- `url` (string | null; optional; max length 1000): A homedepot.com/p/ product link instead of `item_id`.
- `zip_code` (string; required; pattern ^\d{5}(?:-\d{4})?$): US ZIP code to search stores around.
- `radius` (integer; optional; default 25; min 1, max 100): Search radius in miles.
- `max_stores` (integer; optional; default 10; min 1, max 20): Nearest stores to check (1-20).

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)
