thomann.pt APIthomann.pt ↗
Access Thomann Portugal's B-Stock inventory via 6 endpoints. Browse categories, list discounted products, retrieve specs, search by keyword, and fetch daily deals.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1fc71e45-f253-405a-a47f-b038b4040111/get_bstock_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches all top-level B-Stock/Discounted Bargains categories from the Thomann Portugal blowouts page. Returns a list of category names with item counts and URLs.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of category objects with name, count, and url",
"status": "string indicating success"
},
"sample": {
"data": [
{
"url": "https://www.thomann.pt/blowouts_GF_guitarras_e_baixos.html",
"name": "Guitarras e Baixos",
"count": 2031
},
{
"url": "https://www.thomann.pt/blowouts_GF_teclados1.html",
"name": "Teclados",
"count": 370
}
],
"status": "success"
}
}About the thomann.pt API
The Thomann.pt B-Stock API provides 6 endpoints covering the full blowout and discounted inventory on Thomann's Portuguese storefront. Starting with get_bstock_categories, you can walk the category tree down to individual product listings, then call get_bstock_product_detail to retrieve fields like brand, article number, availability, specs, and an images array for any specific item.
Category and Product Navigation
get_bstock_categories returns the top-level blowout taxonomy — each object carries a name, item count, and url. Pass any of those URLs to get_bstock_subcategories to get narrower groupings within that category, using the same three-field shape. From there, get_bstock_products accepts a category or subcategory url, an optional page integer for pagination, and an optional sort parameter that accepts popularity, price_asc, price_desc, rating, or latest. It returns a data object containing a products array, the current page, and a total_count so you can calculate how many pages to iterate.
Product Detail and Search
get_bstock_product_detail takes a product URL from either get_bstock_products or search_bstock_products and returns the full record: name, price, article_number, brand, availability, description_type, an images array, a specs array, and the canonical url. search_bstock_products accepts a query string — a keyword like "Fender" or "microphone" — and returns an array of matching B-Stock items, each with name, article_number, manufacturer, price, availability, is_bstock boolean, rating, review_count, and url. The is_bstock field lets you confirm the result is a blowout item rather than a standard listing.
Daily Deals
get_blowouts_daily_deal takes no parameters and returns the current "Oportunidade do dia" (Deal of the Day) products from the Thomann Portugal blowouts page. Each deal object includes name, price, url, and image_url. This endpoint is useful for monitoring time-sensitive price drops without iterating through the full category tree.
- Track daily price drops on B-Stock musical instruments using
get_blowouts_daily_deal - Build a B-Stock price-alert tool by polling
get_bstock_productswithsort=price_ascand comparing against stored prices - Index Thomann Portugal's full discounted catalog for a deal-aggregation site using the category + subcategory endpoints
- Look up availability and full specs for a specific blowout item by passing its URL to
get_bstock_product_detail - Search by instrument brand or type using
search_bstock_productsand filter results by theis_bstockfield - Analyze category-level inventory depth by comparing the
countfield across categories returned byget_bstock_categories
| 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 have an official public developer API?+
What does `get_bstock_product_detail` return beyond the price?+
name, article_number, brand, availability, description_type, an images array (multiple product images), a specs array (structured technical specifications), and the product's canonical url. It does not include user reviews; review counts are available in search_bstock_products results.Does the search endpoint cover the full Thomann catalog or only B-Stock items?+
is_bstock boolean you can use to confirm discount status. Standard new-product listings from the full Thomann catalog are not covered by this API. You can fork it on Parse and revise to add an endpoint targeting the full catalog search.Is the data specific to Thomann Portugal or does it cover other regional storefronts?+
Does the API expose seller ratings or customer review text for B-Stock products?+
rating and review_count are available in get_bstock_products and search_bstock_products results. Individual review text, reviewer names, and per-review scores are not exposed by any current endpoint. You can fork it on Parse and revise to add a review-detail endpoint for a specific product URL.