# Thomann Scraper — Music Gear Products & Prices (`studio-amba/thomann-de-scraper`) Actor Scrape products, prices, brands, ratings and availability from thomann.de, Europe's largest music-gear retailer (instruments, audio, DJ and studio equipment). Search by keyword. No login needed. - **URL**: https://apify.com/studio-amba/thomann-de-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 result scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Thomann Scraper — Music Gear Products & Prices Scrape products, prices, brands, ratings and stock status from [thomann.de](https://www.thomann.de), Europe's largest music-gear retailer — guitars, keyboards, drums, DJ and studio equipment, microphones, PA systems and accessories. Search by keyword and get clean structured JSON. No login, no cookies, no browser automation. Built for price monitoring, catalog research, and market analysis in the musical-instrument and pro-audio space. ### What it does Thomann publishes its full search-results state as embedded JSON on every search page — so this actor reads that data directly instead of scraping rendered HTML or driving a browser. That means one lightweight HTTP request per page of results, full field coverage (name, brand, price, stock, rating, description, image), and no JavaScript rendering overhead. - **Keyword search** — pass any search term (`gitarre`, `mikrofon`, `keyboard`, `dj controller`) and get matching products across Thomann's entire catalog of 23,000+ items per broad query. - **Automatic pagination** — the actor reads Thomann's own page-count metadata and walks pages until it hits your `maxResults` or runs out of matches, using the verified 100-item page size (2x more efficient than the site's own default of 50). - **Deduplication** — products are deduplicated by internal ID within a run. ### Output Each product is one record. Real example from a live test run (query `gitarre`): ```json { "name": "E-Guitar Gigbag Deluxe", "brand": "Thomann", "price": 29.9, "currency": "EUR", "url": "https://www.thomann.de/de/thomann_gigbag_deluxe_egitarre.htm", "scrapedAt": "2026-07-27T09:11:57.712Z", "sku": "142777", "productId": "27226", "inStock": true, "stockLevel": 576, "deliveryInfo": "Sofort lieferbar", "rating": 4.7, "reviewCount": 1426, "imageUrl": "https://thumbs.static-thomann.de/thumb/thumb220x220/pics/prod/142777.jpg", "productDescription": "Thomann E-Guitar Gigbag Deluxe, für E-Gitarre, 20 mm Polsterung (Expanded Polyethylene), hochbelastbarer Industriewerkstoff für extrem hohen Schutz und Stabilität, 5cm breite gepolsterte Trageriemen, 2 Außentaschen,2 zusätzliche Zubehörtaschen, Fach f. Namensschild, Innenmaße ca. L/B/T 112x40x8cm", "language": "de" } ```` Another example from the same run — a guitar with a strike price: ```json { "name": "HZ7 Satin Galaxy Black", "brand": "Hils", "price": 699, "currency": "EUR", "url": "https://www.thomann.de/de/hils_hz7_satin_galaxy_black.htm", "scrapedAt": "2026-07-27T09:11:57.712Z", "sku": "626755", "productId": "527413", "inStock": true, "stockLevel": 14, "deliveryInfo": "Sofort lieferbar", "rating": 3.5, "reviewCount": 4, "imageUrl": "https://thumbs.static-thomann.de/thumb/thumb220x220/pics/prod/626755.jpg", "productDescription": "Hils HZ7 Satin Galaxy Black, 7-Saitige Headless Multiscale E-Gitarre, ...", "language": "de" } ``` #### Fields | Field | Description | |-------|-------------| | `name` | Product name | | `brand` | Brand / manufacturer | | `price` | Current selling price as a number | | `currency` | Currency code (`EUR`) | | `url` | Full product page URL | | `originalPrice` | Strike-through price, when the item is discounted (present when lower than `price` would suggest a markdown) | | `discount` | Computed discount percentage (e.g. `-15%`), when a strike price is present | | `sku` | Thomann's internal article number | | `productId` | Thomann's internal product ID | | `inStock` | Whether the product is currently available | | `stockLevel` | Exact stock quantity, when disclosed | | `deliveryInfo` | Human-readable availability text (e.g. `Sofort lieferbar` = ships immediately) | | `rating` | Average customer rating, normalized to a 0–5 scale | | `reviewCount` | Number of customer reviews | | `imageUrl` | Primary product image URL | | `productDescription` | Short product description | | `language` | Content language (`de`) | | `scrapedAt` | ISO 8601 timestamp of the scrape | ### How to scrape Thomann data 1. Open the actor and set a **Search Query** (for example `gitarre`, `mikrofon`, `keyboard`, `pa lautsprecher`). Leave it empty and it defaults to `gitarre`. 2. Set **Max Results** to the number of products you want. 3. Keep the default **Proxy Configuration** (residential, Germany) — thomann.de has no anti-bot protection, but routing through Germany keeps results consistent with the `.de` storefront and currency. 4. Click **Start**. When the run finishes, download the dataset as JSON, CSV or Excel, or pull it from the API. #### Input example ```json { "searchQuery": "mikrofon", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "DE" } } ``` #### Input example — full-catalog pull for a niche term ```json { "searchQuery": "dj controller", "maxResults": 500 } ``` ### Cost estimate This actor runs on the STANDARD pay-per-result pricing tier. A single HTTP request returns up to 100 fully-populated products, so a 500-result run costs about 5 requests plus compute — a few cents of platform usage on top of the per-result price. No browser rendering means minimal compute cost compared to Playwright-based scrapers. ### Common use cases - **Price monitoring** — track prices on guitars, keyboards, audio interfaces and other gear over time. - **Catalog research** — pull structured data on Thomann's assortment for a category or brand. - **Competitive analysis** — compare Thomann's pricing against other European music-gear retailers. - **Availability tracking** — monitor stock levels and delivery status on specific SKUs. ### Limitations - Covers thomann.de (the German storefront, EUR pricing) — Thomann's other country storefronts are not covered by this actor. - Category names aren't included in the output (Thomann's search JSON only exposes internal numeric category IDs, not human-readable names) — use the search keyword itself, or the product `description`, to infer category. - Search relevance and result order follow Thomann's own sorting; the actor doesn't re-rank results. ### FAQ **Does this need a login?** No. The actor only reads publicly published search-results data. No account, password or cookies are required. **Does it use a headless browser?** No. Thomann's search-results page embeds the full product dataset as JSON in the page's own HTML, so a plain HTTP request is all that's needed — no Playwright, no rendering cost. **Why is `originalPrice` sometimes missing?** Most products are listed at their normal price with no strike-through comparison. `originalPrice` and `discount` only appear when Thomann shows a markdown on that item. **Is this legal?** The actor collects publicly available product and pricing information. You are responsible for using the data in line with Thomann's terms and applicable law. ### Related Scrapers - [MediaMarkt DE Scraper](https://apify.com/jelle.desramaults/mediamarkt-de-scraper) — German consumer electronics retailer - [Conrad Scraper](https://apify.com/jelle.desramaults/conrad-scraper) — German electronics and components retailer - [Reichelt Scraper](https://apify.com/jelle.desramaults/reichelt-scraper) — German electronics and components ### Disclaimer This actor is an independent tool and is not affiliated with, endorsed by, or connected to Thomann GmbH or thomann.de. All product data belongs to its respective owners. # Actor input Schema ## `searchQuery` (type: `string`): Search for products by keyword (e.g., 'gitarre', 'mikrofon', 'keyboard'). German terms work best since this is the .de storefront. Leave empty to default to 'gitarre'. ## `maxResults` (type: `integer`): Maximum number of products to return. ## `proxyConfiguration` (type: `object`): Proxy settings for accessing thomann.de. Residential DE proxies recommended for scale, though the site has no anti-bot protection. ## Actor input object example ```json { "searchQuery": "gitarre", "maxResults": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "gitarre", "maxResults": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/thomann-de-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "gitarre", "maxResults": 5, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "DE", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/thomann-de-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "gitarre", "maxResults": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }' | apify call studio-amba/thomann-de-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/thomann-de-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Thomann Scraper — Music Gear Products & Prices", "description": "Scrape products, prices, brands, ratings and availability from thomann.de, Europe's largest music-gear retailer (instruments, audio, DJ and studio equipment). Search by keyword. No login needed.", "version": "0.1", "x-build-id": "RGE82eVdpNjEIQdyU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~thomann-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-thomann-de-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~thomann-de-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-thomann-de-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~thomann-de-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-thomann-de-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search for products by keyword (e.g., 'gitarre', 'mikrofon', 'keyboard'). German terms work best since this is the .de storefront. Leave empty to default to 'gitarre'." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for accessing thomann.de. Residential DE proxies recommended for scale, though the site has no anti-bot protection." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```