# Kohl's Products API Documentation

<p><strong>Kohl's Products API Documentation</strong> List public Kohl's products that work with Kohl's Reviews. The default page covers active products. Each row carries its web id, name, brand, image, numeric rating and review count. Send id to read one exact web id, or category to restrict the list to one public Kohl's category. Page with a 1-based page and set rows per page with limit, up to 50. Every id is accepted unchanged by the reviews endpoint. Each request costs 1 credit when rows are returned; a failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/kohls-api/kohls_products](https://scrappa.co/docs/kohls-api/kohls_products)
- **API group:** Kohls API
- **Endpoint:** `GET https://scrappa.co/api/kohls/products`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Optional public Kohl's product web id, for example 2764568. Reads one product instead of the listing. |
| `category` | string | No | Optional public Kohl's category id, for example Pretend_Play. |
| `page` | integer | No | 1-based page, default 1. |
| `limit` | integer | No | Rows per page, default 20, maximum 50. |

## Example response

```json
{
    "data": {
        "products": [
            {
                "id": "1002562",
                "name": "Girls Jacques Moret Dance Tights",
                "brand": "Jacques Moret",
                "image": "https://media.kohlsimg.com/is/image/kohls/1002562_Black?wid=800&hei=800&op_sharpen=1&ver=1",
                "rating": 3.71,
                "review_count": 52
            }
        ],
        "pagination": {
            "per_page": 20,
            "current_page": 1,
            "has_next_page": true,
            "total_results": 945418
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "duration_ms": 450,
        "endpoint_family": "products"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is invalid. Kohl's is not called and the request is not billable. |
| 503 | Upstream Unavailable | Kohl's did not answer. Retry later. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
