# Thomann Product Reviews API

> Customer reviews of any Thomann product, with review title, author, date, star rating and review text.

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

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 | `Sehr schöne Ukulele für Leute die nicht Ukulele spielen` |
| `date` | string | `13.03.2021` |
| `rating` | number | `5` |
| `author` | string | `F aus S` |
| `text` | string | `Kurz vorweg: Ich bin eigentlich Gitarrist und war auf der Suche nach einer Ukul…` |

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-product-reviews-api/contract.json

## Inputs

- `rating` (string \| number): Optional. Filters by the site's rating control. Options: 5 74 Kunden (5), 4 23 Kunden (4), 3 1 Kunde (3), 1–5 Sterne (0).
- `reviewlang` (string \| number): Optional. Filters by the site's reviewlang control. Options: Alle Sprachen (67) (all), Deutsch (22) (1), Englisch (7) (2), Finnisch (1) (3), Französisch (20) (4), Schwedisch (1) (5), Portugiesisch (2) (6), Niederländisch (2) (7), and 3 more in https://cleanedweb.com/catalog/thomann-product-reviews-api/contract.json.
- `product` (string, required): Free text: any product the site serves, written with letters, digits, underscores and hyphens, up to 70 characters. A name the site does not serve is refused with input_value_unverified. For example: harley_benton_kahuna_s_turtle, harley_benton_ukulele_uk_11dw_brown. Pattern: `^[A-Za-z0-9_][A-Za-z0-9_\-]{0,69}$`.
- `order` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Hilfreichste zuerst (helpful), Neueste zuerst (latest), Schlechte Bewertungen zuerst (rating_asc).

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_2480f250005f6f26e7dd193a/endpoints/generated_2480f250005f6f26e7dd193a_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_2480f250005f6f26e7dd193a/endpoints/generated_2480f250005f6f26e7dd193a_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "product": "harley_benton_kahuna_s_turtle",
    "rating": 5
  },
  "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_2480f250005f6f26e7dd193a/endpoints/generated_2480f250005f6f26e7dd193a_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-product-reviews-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_2480f250005f6f26e7dd193a`, 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.
