Thomann APIthomann.fr ↗
Search Thomann.fr's catalog of musical instruments and audio equipment. Get product prices, ratings, availability, and manufacturer data via one API endpoint.
What is the Thomann API?
The Thomann.fr API provides access to Thomann's French-market musical instrument and audio equipment catalog through a single search_products endpoint that returns up to 16 fields per product, including price, currency, manufacturer, rating, rating count, and availability. You can paginate through results, control page size (25, 50, or 100 items), and sort listings to match your use case.
curl -X GET 'https://api.parse.bot/scraper/c23f8095-41c1-48b8-9fd4-227d74284c21/search_products?sort=smb&limit=25&query=headphones' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Thomann.fr by keyword. Returns paginated results with product details including price, availability, rating, and features. Results are sorted by popularity by default. Each page returns up to the specified limit of products (25, 50, or 100). Use the page parameter to navigate through results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (starts at 1). |
| sort | string | Sort order for results. |
| limit | integer | Number of products per page. Must be one of: 25, 50, or 100. |
| queryrequired | string | Search keyword or phrase (e.g. 'yamaha piano', 'headphones', 'microphone'). |
{
"type": "object",
"fields": {
"limit": "Number of results per page",
"query": "The search query that was executed",
"products": "Array of product objects with id, article_number, manufacturer, model, title, subtitle, price, currency, rating, rating_count, availability, in_stock, features, image_url, and url",
"last_page": "Last available page number",
"current_page": "Current page number",
"total_results": "Estimated total number of results (last_page * limit)"
},
"sample": {
"data": {
"limit": 25,
"query": "headphones",
"products": [
{
"id": 200712,
"url": "https://www.thomann.fr/the_tbone_headphone_adapter.htm?type=quickSearch",
"model": "Headphone Adapter",
"price": 2.99,
"title": "the t.bone Headphone Adapter",
"rating": 9.694,
"currency": "EUR",
"features": [
"Encastrable",
"Mini Jack 3,5 mm femelle - Jack mâle 6,3 mm"
],
"in_stock": true,
"subtitle": "Adpatateur stéréo pour casque",
"image_url": "https://thumbs.static-thomann.de/thumb/thumb220x220/pics/prod/300470.webp",
"availability": "Disponible immédiatement",
"manufacturer": "the t.bone",
"rating_count": 5661,
"article_number": "300470"
}
],
"last_page": 83,
"current_page": 1,
"total_results": 2075
},
"status": "success"
}
}About the Thomann API
What the API returns
The search_products endpoint accepts a required query string — anything from 'yamaha piano' to 'condenser microphone' — and returns an array of product objects from Thomann.fr's catalog. Each product includes id, article_number, manufacturer, model, title, subtitle, price, currency, rating, rating_count, and availability status. The response also carries pagination metadata: current_page, last_page, limit, and total_results (calculated as last_page * limit).
Pagination and sorting
Results default to popularity ordering. The optional sort parameter lets you override this. Page size is controlled by the limit parameter and must be exactly 25, 50, or 100. The page parameter (starting at 1) lets you walk through deeper result sets. total_results gives an estimate of catalog depth for a given query, useful for building paginated UIs or estimating coverage before fetching all pages.
Coverage and scope
The API targets thomann.fr, Thomann's French-language storefront. Prices are returned in the currency field alongside the numeric price, so downstream consumers can format display correctly. Because results reflect the French regional storefront, pricing and availability may differ from thomann.de or thomann.co.uk. Product detail pages, bundle configurations, and customer review text are not exposed — the endpoint covers search-level data only.
The Thomann API is a managed, monitored endpoint for thomann.fr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when thomann.fr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official thomann.fr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track street prices for specific instruments (e.g., 'fender stratocaster') across Thomann.fr to monitor market movements.
- Build a product comparison tool using
manufacturer,model,price, andratingfields returned per search. - Aggregate
ratingandrating_countdata to identify top-rated products in a given equipment category. - Feed a gear recommendation engine by querying category terms and ranking results by
ratingorprice. - Monitor
availabilitystatus for high-demand items like synthesizers or audio interfaces. - Populate a music gear blog or newsletter with current Thomann.fr listings and prices for a given topic.
- Cross-reference
article_numbervalues against your own inventory to detect catalog overlap or gaps.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Thomann have an official developer API?+
What does the `search_products` endpoint actually return for each product?+
id, article_number, manufacturer, model, title, subtitle, price, currency, rating, rating_count, and availability status. Pagination fields (current_page, last_page, limit, total_results) accompany the product array.Does the API cover product detail pages, specifications, or full customer review text?+
Are results specific to the French Thomann storefront?+
How accurate is the `total_results` field?+
total_results is an estimate derived from last_page * limit. It reflects the pagination depth Thomann exposes for a given query rather than a precise database count, so it may not match a figure shown on the site's own search UI.