# Thomann Category Products API

> Products of any Thomann category page, with product name, brand, price, currency, rating, review count, availability, image and product link.

- Page: https://cleanedweb.com/catalog/thomann-category-products-api/
- Contract (JSON): https://cleanedweb.com/catalog/thomann-category-products-api/contract.json
- Source: thomann.de (https://www.thomann.de/)
- Category: Commerce
- Updated: 2026-11-20

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Harley Benton ST-20HSS SBK Standard Series` |
| `price` | number | `111` |
| `currency` | string | `EUR` |
| `brand` | string | `Harley Benton` |
| `model` | string | `ST-20HSS SBK Standard Series` |
| `location` | string | `product` |
| `rating` | number | `9.1748` |
| `url` | string | `https://www.thomann.de/de/harley_benton_st_20hss_sbk_standard_series.htm?type=category` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `search` (string): Optional. Text for the site's search box. Leave it out to read everything.
- `feature_151` (string): Optional. Filters the results. Options: Amethyst Sparkle, Andromeda, Aqua Burst, Aurora, Autumn, Beige, Bengal, Bernstein, and 92 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_2122` (string): Optional. Filters the results. Options: Ahorn, Ahorn, Bubinga, Ahorn, Carbon, Ahorn, Carbon, Padauk, Ahorn, Carbon, Padauk, Walnuss, Ahorn, Carbon, Palisander, Ahorn, Carbon, Purpleheart, Ahorn, geflammt, and 36 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_2121` (string): Optional. Filters the results. Options: Ahorn, Ahorn Burl, Ahorn, geflammt, Ahorn, geflammt, laminiert, Ahorn, laminiert, Ahorn, Panga Panga, Pappel, Ahorn, Quilt, Ahornfurnier, geflammt, and 26 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_154` (string): Optional. Filters the results. Options: Ahorn, Ahorn, geröstet, Amaranth, Blackwood, Cocobolo, Ebenholz, Ebenholz / Riegelahorn, Engineered Hartholz, and 24 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_153` (string): Optional. Filters the results. Options: 2-Point Deluxe Synchronized Tremolo, 2-Punkt, Babicz FCH 2-Point Z-Series C full contact tremolo, Cort 2-Punkt, Cort CFA-III, Double Locking, Edge, Edge-Zero II, and 24 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `manufacturer` (string): Optional. Filters by manufacturer. Options: Harley Benton, Fender, Ibanez, PRS, ESP, Charvel, Jackson, Squier, and 20 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_2120` (string): Optional. Filters the results. Options: Abachi, Ahorn, Ahorn, Mahagoni, Black Limba, Ebenholz, Erle, Esche, Kastanie, and 15 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_2124` (string \| number): Optional. Filters the results. Options: 564, 572, 609, 624, 625, 628, 629, 635, and 10 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `feature_152` (string): Optional. Filters the results. Options: H, H, P90, H, Sustainiac, HH, HH, HH, HH, Sustainiac, HHH, HP, and 9 more in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json.
- `rating` (string \| number): Optional. Filters by rating. Options: 100 (5), 80 (4), 60 (3), 40 (2), 20 (1).
- `feature_2123` (string \| number): Optional. Filters the results. Options: 20, 21, 22, 24, 27.
- `marketingattributes` (string): Optional. Filters by marketingattributes. Options: Bundle ausschließen (EXCLUDE_BUNDLE), Hot Deals (HOTDEALS), Neuheiten & Trends (PRODNEWS), Schnäppchen (BLOWOUT), Cyber Deals (CYBERWEEK).
- `feature_2131` (string): Optional. Filters the results. Options: Ja, Nein.
- `feature_2130` (string): Optional. Filters the results. Options: Ja, Nein.
- `vf` (string \| number): Optional. Filters the results. Options: Sofort lieferbar (1171).
- `price_min` (string \| integer): Optional. Omit it to leave this side open.
- `price_max` (string \| integer): Optional. Omit it to leave this side open.
- `category` (string, required): Free text: any category the site serves, written with letters, digits, underscores and hyphens, up to 32 characters. A name the site does not serve is refused. For example: st-modelle, t-modelle. Pattern: `^[A-Za-z0-9][A-Za-z\-_0-9]{0,31}$`.
- `sort` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Günstigste zuerst (pra), Teuerste zuerst (prd), Beste Bewertungen zuerst (rat), Neueste Produkte zuerst (rel), Alphabetisch (A–Z) (ala), Alphabetisch (Z–A) (ald).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_e11f346108f62d7286e7795a/endpoints/generated_e11f346108f62d7286e7795a_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_e11f346108f62d7286e7795a/endpoints/generated_e11f346108f62d7286e7795a_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "category": "st-modelle",
    "manufacturer": "Harley Benton"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_e11f346108f62d7286e7795a/endpoints/generated_e11f346108f62d7286e7795a_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-18

The same changelog, as data, is in https://cleanedweb.com/catalog/thomann-category-products-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_e11f346108f62d7286e7795a`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Thomann Music Products.
