What you get
| Field | Type | Sample value |
|---|---|---|
price |
number | 29.9 |
currency |
string | EUR |
brand |
string | Harley Benton |
model |
string | Kahuna-S Turtle |
rating |
number | 9.4845 |
url |
string | thomann.de/de/harley_benton_kahuna_s_turt… |
action |
string | wishlist |
affiliation |
string | Online Store |
All 88 fields
Key fields
pricecurrencybrandmodelratingurlactionaffiliationaudiosavailability_codeavailability_labelavailability_stock_quantitycampaigns_namecampaigns_urlcategorycategory2category3collection_labeldisposition_keyexpress_stock_quantityfeaturesfile_namegiveawayglobal_rankhas_audio_player_buttonheightimage_file_nameimage_typelongmax_valuenumberpositionprice_discountprice_saving_percentageprice_strike_price_raw_priceprice_vat_rateprimary_raw_priceprioritypromotion_namerelations_keyreview_countrich_descriptionsales_ranksales_unit_codeshortsub_titletexts_descriptiontexts_titlevariantwidthwishlist_url
Technical fields
a_stock_article_idavailability_dateavailablecampaigns_article_idcampaigns_idcategory4category_iddisplay_namedownload_infohas_discounthas_fsi_spin_dataidimage_idis_archivedis_bstockis_downloadis_express_shippableis_on_wishlistis_returnableis_voucheris_yamaha_agencyitem_iditem_indexitem_nameitem_quantityparent_idprice_includes_vatprimary_includes_vatquantityrelations_idrestrictionretail_includes_vatretail_raw_priceretail_saving_percentageretail_vat_ratetagsuvp
Every field with its type, and the schemas, are in contract.json.
Sample records
1 of 3 saved records. This is a saved sample, not a live run.
model |
price |
currency |
brand |
rating |
url |
|---|---|---|---|---|---|
| Kahuna-S Turtle | 29.9 | EUR | Harley Benton | 9.4845 | thomann.de/de/harley_benton_kahuna_s_turt… |
Scroll sideways to see more columns.
Inputs
-
manufacturerchoiceOptional. Filters by the site's manufacturer control.
-
categorychoiceOptional. Filters by the site's category control.
-
ratingchoiceOptional. Filters by the site's rating control.
-
marketingattributeschoiceOptional. Filters by the site's marketingattributes control.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_ef2595d47b91cc608bbec022/endpoints/generated_ef2595d47b91cc608bbec022_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_ef2595d47b91cc608bbec022/endpoints/generated_ef2595d47b91cc608bbec022_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"manufacturer": "Kala"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Thomann Ukuleles and Accessories API.
The agent calls get_api with generated_ef2595d47b91cc608bbec022, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Commerce
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Thomann Music Products.