# Home Depot Category API (https://www.socialcrawl.dev/platforms/home_depot/category)

> Returns products listed in a Home Depot category, 24 per page by default and up to 48, with the same row shape as GET /v1/home_depot/search: item id, title, brand, model number, price, rating, review count, images, and stock status. Category ids are the 5yc1v… navigation segment of a homedepot.com category URL, and also come back in the breadcrumbs and filters of a search response. One upstream caveat measured on the live source: category rows return a null product.url even though search rows populate it, so resolve the item id through GET /v1/home_depot/product when you need a link.

TL;DR: `GET /v1/home_depot/category` 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 |
| --- | --- | --- |
| `category_id` | yes | Home Depot category id, the 5yc1v… segment of a homedepot.com category URL, for example 5yc1vZc1xy. Also returned in the breadcrumbs and filters of GET /v1/home_depot/search. |
| `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/category?category_id=5yc1vZc1xy" \
  -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