# Home Depot Search API (https://www.socialcrawl.dev/platforms/home_depot/search)

> Returns Home Depot products matching a keyword, 24 per page by default and up to 48, each with its item id, title, brand, model number, current and original price, star rating, review count, image gallery, stock status, and department. Feed a returned item id into GET /v1/home_depot/product for full detail including per-store shelf counts, or GET /v1/home_depot/reviews for the review text. Pass store_id or zipcode to localise pricing and availability. This is also the keyword-to-item-id resolver for the rest of the Home Depot API.

TL;DR: `GET /v1/home_depot/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Free-text product search, for example drill or cordless impact driver. |
| `page` | no | Page number, 1 to 30. Prefer the universal cursor parameter. |
| `items_per_page` | no | Products per page, 1 to 48. Defaults to 24. |
| `sort_by` | no | Result ordering: best_match (default), top_sellers, top_rated, price_low_to_high, price_high_to_low, or newest. (best_match \| top_sellers \| top_rated \| price_low_to_high \| price_high_to_low \| newest) |
| `brand` | no | Return only products from one brand, for example DEWALT. |
| `min_price` | no | Lowest price to include, in USD. Applied by Home Depot and approximate, so filter on product.price.current if you need a hard bound. |
| `max_price` | no | Highest price to include, in USD. Applied by Home Depot and approximate, so filter on product.price.current if you need a hard bound. |
| `in_stock` | no | Set true to return only products Home Depot can fulfil now. |
| `store_id` | no | Home Depot store number used to localise price, stock, and pickup availability, for example 121. |
| `zipcode` | no | Five-digit US ZIP code used to localise delivery options and pricing, for example 30301. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/home_depot/search?query=drill" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Home Depot API: https://www.socialcrawl.dev/platforms/home_depot

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing