thomann.de APIthomann.de ↗
Access Thomann's music store catalog via API. Search products, browse categories, retrieve specs, pricing, availability, and customer reviews.
curl -X GET 'https://api.parse.bot/scraper/6af99b32-0117-475c-82e4-622fd744b176/search_products?query=Gibson' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Thomann. Returns paginated results with product summaries including price, rating, and availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| limit | integer | Max results per page. Accepted values: 25, 50, 100. |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"total": "integer total number of matching products",
"products": "array of product summary objects with id, item_number, name, brand, model, url, price, currency, availability, rating, review_count, features, image"
},
"sample": {
"data": {
"page": 1,
"total": 800,
"products": [
{
"id": 362950,
"url": "https://www.thomannmusic.com/gibson_sg_61_standard_vc.htm?type=quickSearch",
"name": "Gibson SG 61 Standard VC",
"brand": "Gibson",
"image": "https://thumbs.static-thomann.de/thumb/thumb400x400/pics/prod/462531.jpg",
"model": "SG 61 Standard VC",
"price": "1790.0000",
"rating": 9.3766,
"currency": "USD",
"features": [
"Body: Mahogany",
"Neck: Mahogany",
"Fingerboard: Rosewood"
],
"item_number": "462531",
"availability": "In stock",
"review_count": 77
}
]
},
"status": "success"
}
}About the thomann.de API
The Thomann API exposes 6 endpoints covering product search, detailed specs, category browsing, and customer reviews from one of Europe's largest music retail catalogs. search_products returns paginated results with price, availability, and rating data across the full Thomann inventory. get_product_details delivers EAN barcodes, brand, model, description, and a numeric rating score for any individual product.
Product Search and Filtering
search_products accepts a query string and returns paginated product summaries including id, item_number, name, brand, model, url, price, currency, availability, rating, and review_count. The limit parameter accepts 25, 50, or 100 results per page. For narrower queries, filter_products adds min_price, max_price, manufacturer, and category_url parameters on top of keyword search, giving you multi-axis filtering in a single call.
Product Details and Reviews
get_product_details takes a product page URL or slug and returns the full record: ean, image, price, rating (out of 10), currency, and structured description fields. Reviews are handled separately by get_product_reviews, which accepts a Thomann item_number (the product_id field) and returns paginated review objects containing author, date, rating_percent, stars, and review text. The item_number used here maps directly to the item_number field returned by search_products.
Category Navigation
get_all_categories takes no inputs and returns the top-level category tree as an array of objects with name and url. Those url slugs feed directly into get_category_listings, which paginates all products under a given category and returns the same product summary shape as search. This makes it straightforward to crawl a specific department — guitars, studio monitors, or DJ gear — without constructing search queries.
- Track Thomann price changes on specific products using
get_product_detailsprice and currency fields - Build a music gear price comparison tool by matching EAN barcodes from
get_product_detailsagainst other retailers - Aggregate customer sentiment by collecting review
starsandtextfields fromget_product_reviewsacross product lines - Index a specific instrument category for a niche storefront using
get_category_listingswith a category slug fromget_all_categories - Filter in-stock products by manufacturer and price band using the
manufacturer,min_price, andmax_priceparams onfilter_products - Monitor brand availability and rating trends by periodically calling
search_productsfor a manufacturer name
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Thomann offer an official developer API?+
What does `get_product_reviews` return and how is pagination handled?+
get_product_reviews requires a product_id matching the item_number from search results. Each review object includes author, date, rating_percent, stars, and full review text. Pagination is controlled by the page parameter; the response echoes back the current page number alongside the reviews array.Does `get_product_details` always return an EAN barcode?+
ean field is returned when Thomann lists it for the product, but it can be null. Coverage varies by product type — accessories and bundled items are less likely to carry a barcode than standalone instruments or electronics.Does the API cover Thomann's used or outlet products?+
Can I retrieve product availability by warehouse location or shipping region?+
availability field in product summaries reflects the general stock status shown on the product listing. Region-specific shipping lead times and per-warehouse stock splits are not broken out as separate fields. You can fork the API on Parse and revise it to add more granular availability data if the source exposes it for your target region.