# JYSK Category API Documentation

<p><strong>JYSK Category API</strong> lists the public products of one category page with position, title, product url and full-size image URLs. Take a path from the Sitemap route or send a full jysk.de category url.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/jysk-api/jysk_category](https://scrappa.co/docs/jysk-api/jysk_category)
- **API group:** JYSK API
- **Endpoint:** `GET https://scrappa.co/api/jysk/category`

## 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 |
| --- | --- | --- | --- |
| `path` | string | No | Category path, for example /schlafzimmer/matratzen. Send path or url. |
| `url` | string | No | Full jysk.de category url. Send url or path. |

## Example response

```json
{
    "data": {
        "path": "/schlafzimmer/matratzen",
        "items": [
            {
                "url": "https://jysk.de/schlafzimmer/matratzen/beispielmatratze",
                "title": "Schaummatratze",
                "position": 1,
                "image_urls": [
                    "https://cdn1.jysk.com/getimage/wd3.medium/3398032"
                ]
            }
        ],
        "source": "jysk"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "category"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The category page has no public product list. This response is not billed. |
| 422 | Validation Error | Send a category path or a jysk.de category url. This response is not billed. |
| 503 | Upstream Unavailable | JYSK could not be reached. This response is not billed and is retryable. |

## 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)
