# Subito.it Musical Instrument Scraper (`nogards95/subito-strumenti-musicali`) Actor Extract musical instrument listings from Subito.it. Search for guitars, keyboards, drums, basses and more with price filters. Perfect for musicians and resellers. - **URL**: https://apify.com/nogards95/subito-strumenti-musicali.md - **Developed by:** [Nogards](https://apify.com/nogards95) (community) - **Categories:** E-commerce, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Subito.it Strumenti Musicali Scraper Fast and optimized scraper for musical instrument listings on Subito.it, Italy's leading classifieds marketplace. ### 🎯 What it does Extracts musical instrument listings from Subito.it based on your search criteria: - Search by keyword within the Strumenti Musicali category - Filter by price range - Get clean, structured JSON data - Scrape multiple pages efficiently - Optimized for low memory usage and fast performance ### 💰 Who is this for - 🎸 Musicians looking for second-hand instruments at the best price - 🏪 Music shop owners monitoring the used instrument market - 🔍 Deal hunters tracking specific instruments or brands - 📊 Price comparison and market research across instrument types - 🤖 Automated deal alerts for rare or collectible instruments - 📈 Market trend analysis for specific instrument categories ### 🚀 Input ```json { "keyword": "chitarra fender", "minPrice": 100, "maxPrice": 800, "maxPages": 5, "location": "milano" } ```` #### Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | keyword | string | Yes | — | What to search for (e.g., 'chitarra fender', 'pianoforte', 'basso elettrico') | | minPrice | integer | No | null | Minimum price in euros | | maxPrice | integer | No | null | Maximum price in euros | | maxPages | integer | No | 3 | Number of pages to scrape (max: 50, ~30 results per page) | | location | string | No | null | Location filter (e.g., 'milano', 'roma', 'italia') | #### Example inputs **Search for Fender guitars under €800:** ```json { "keyword": "chitarra fender", "maxPrice": 800, "maxPages": 3 } ``` **Search for pianos nationwide:** ```json { "keyword": "pianoforte", "maxPages": 5, "location": "italia" } ``` **Search for electric basses with price range:** ```json { "keyword": "basso elettrico", "minPrice": 150, "maxPrice": 600, "maxPages": 3, "location": "roma" } ``` ### 📦 Output Clean JSON array with each listing containing: ```json { "title": "Chitarra Fender Stratocaster American Standard", "price": 650, "priceRaw": "650 €", "currency": "EUR", "link": "https://www.subito.it/...", "location": "Milano (MI)", "images": ["image_url"] } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | title | string | Listing title as shown on Subito.it | | price | number | Parsed price as a number (null if not available) | | priceRaw | string | Raw price string as shown (e.g., "650 €") | | currency | string | Always "EUR" | | link | string | Full URL to the listing on Subito.it | | location | string | Seller location (city and province) | | images | array | Array with the first listing image URL | ### ⚙️ How it works 1. Builds search URL targeting `https://www.subito.it/annunci-italia/vendita/strumenti-musicali/` 2. Appends your keyword, price filters, and pagination parameters 3. Navigates through result pages with an optimized Playwright browser 4. Extracts listing details efficiently using DOM selectors 5. Returns structured data ready for use ### 🔧 Technical details - Uses Playwright with optimized browser settings - Handles pagination automatically - Low memory footprint (< 1GB RAM) - Optimized selectors for fast extraction - Efficient cookie consent handling - Reduced timeouts for faster scraping - Blocks images, fonts, and media to minimize memory usage ### 📊 Performance | Pages | Approx. results | Approx. run time | Memory usage | |-------|----------------|-----------------|--------------| | 1 | ~30 | ~30s | < 512MB | | 3 (default) | ~90 | ~90s | < 1GB | | 10 | ~300 | ~5min | < 1GB | | 50 (max) | ~1500 | ~25min | < 2GB | ### 💡 Use cases **For musicians:** Track second-hand prices for a specific brand or model to know when a deal is good **For resellers:** Monitor listings for underpriced instruments you can flip or restore **For researchers:** Analyze the second-hand market for a category of instruments (e.g., vintage guitars, acoustic pianos) ### 📊 Pricing - **Free tier**: Try it with $5 free credits monthly - **Pay per result**: $X per 1,000 results - No subscription required ### 🛟 Support Found a bug? Have a feature request? Open an issue on GitHub or contact via Apify. ### ⚖️ Legal This scraper respects Subito.it's terms of service and robots.txt. Only publicly available data is extracted. Use responsibly and in accordance with local laws. *** Built with ❤️ using [Apify](https://apify.com) and [Crawlee](https://crawlee.dev) # Actor input Schema ## `keyword` (type: `string`): What to search for (e.g., 'chitarra fender', 'pianoforte', 'basso elettrico') ## `minPrice` (type: `integer`): Minimum price in euros (optional) ## `maxPrice` (type: `integer`): Maximum price in euros (optional) ## `maxPages` (type: `integer`): How many pages to scrape (each page ~30 results) ## `location` (type: `string`): Location filter (e.g., 'milano', 'roma', 'italia') ## Actor input object example ```json { "keyword": "chitarra fender", "minPrice": 50, "maxPrice": 800, "maxPages": 5, "location": "milano" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("nogards95/subito-strumenti-musicali").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 = {} # Run the Actor and wait for it to finish run = client.actor("nogards95/subito-strumenti-musicali").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 '{}' | apify call nogards95/subito-strumenti-musicali --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nogards95/subito-strumenti-musicali", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Subito.it Musical Instrument Scraper", "description": "Extract musical instrument listings from Subito.it. Search for guitars, keyboards, drums, basses and more with price filters. Perfect for musicians and resellers.", "version": "1.0", "x-build-id": "EW5T399ZF7Y7Guv2V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nogards95~subito-strumenti-musicali/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nogards95-subito-strumenti-musicali", "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/nogards95~subito-strumenti-musicali/runs": { "post": { "operationId": "runs-sync-nogards95-subito-strumenti-musicali", "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/nogards95~subito-strumenti-musicali/run-sync": { "post": { "operationId": "run-sync-nogards95-subito-strumenti-musicali", "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", "required": [ "keyword" ], "properties": { "keyword": { "title": "Search Keyword", "type": "string", "description": "What to search for (e.g., 'chitarra fender', 'pianoforte', 'basso elettrico')" }, "minPrice": { "title": "Minimum Price (€)", "type": "integer", "description": "Minimum price in euros (optional)" }, "maxPrice": { "title": "Maximum Price (€)", "type": "integer", "description": "Maximum price in euros (optional)" }, "maxPages": { "title": "Maximum Pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages to scrape (each page ~30 results)", "default": 3 }, "location": { "title": "Location", "type": "string", "description": "Location filter (e.g., 'milano', 'roma', 'italia')" } } }, "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 } } } } } } } } } } ```