# Thalia Category Listing API Documentation

Scrappa's `GET /api/thalia/category` returns public Thalia book and media data as JSON. List the products of one category.

## Credits

This route costs 25 credits when it returns data. Search, product, reviews and category cost 25 credits, sale costs 50, and the tiny availability and autocomplete routes cost 1. The public article ids route costs 1. An empty result, a validation error and every failure cost nothing. Clients are never rate limited.

## Storefronts

`country=de` (default) and `country=at` are supported. Both return prices in EUR.

## Filters and totals

`sort`, `format` and the price bounds are sent upstream. `format` and the price
bounds are also checked on the returned cards, so cards that violate a request
are removed. `total` keeps the upstream count, `upstream_total` repeats it and
`total_pages` is the upstream page count. `filter_scope.upstream` names the
filters sent upstream.

## Identifiers

Article ids such as `A1074644377` come from search, categories, sale or the public id route and work unchanged in product, reviews and availability. ISBN, EAN and article ids stay strings so leading zeros are preserved.

- **Documentation:** [https://scrappa.co/docs/thalia-api/thalia_category](https://scrappa.co/docs/thalia-api/thalia_category)
- **API group:** Thalia API
- **Endpoint:** `GET https://scrappa.co/api/thalia/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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | Numeric category id, for example 3 or 4893. |
| `page` | integer | No | 1-based page, up to 50. |
| `country` | string | No | de (default) or at. |
| `format` | string | No | Binding or format, for example Taschenbuch. |
| `min_price` | number | No | Minimum price in EUR. |
| `max_price` | number | No | Maximum price in EUR. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/thalia/category?id=3"
```

## Example response

```json
{
    "success": true,
    "endpoint_family": "category",
    "locale": "de",
    "meta": {
        "endpoint_family": "category",
        "billable": true,
        "credits": 25,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 404 | Not Found | No Thalia record exists with that id (`not_found`). Non-billable. |
| 503 | Upstream Unavailable | Thalia could not be reached or changed its format. Retryable and never billed. Clients are never rate limited. |

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