# HifiShark Used Hifi Listing Aggregator Scraper (`jungle_synthesizer/hifishark-used-hifi-listing-aggregator-scraper`) Actor Scrape used hi-fi listings from HifiShark.com — the meta-search engine covering 600+ second-hand audio marketplaces. Search by keyword and extract price, source site, country, and direct listing URLs across Audiogon, USAudioMart, eBay, and 600+ other sources in a single run. - **URL**: https://apify.com/jungle\_synthesizer/hifishark-used-hifi-listing-aggregator-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ## HifiShark Used Hifi Listing Aggregator Scraper Scrape used hi-fi equipment listings from **HifiShark.com** — the world's leading meta-search engine for second-hand audio gear. One search returns current listings from 600+ marketplaces worldwide including Audiogon, USAudioMart, eBay, hifi-forsale, Marktplaats, ricardo.ch, and hundreds more. ### What it does Supply a list of search terms (brand names, model numbers, or equipment categories). For each term, the actor fetches the HifiShark search results page and extracts all current listings with their prices, source sites, countries, images, and direct links to the original listings. Each search query returns up to 48 current listings from across all indexed marketplaces. Use multiple queries to maximize coverage — e.g., search by brand (`Marantz PM-10`), by model family (`Naim Nait`), or by category (`turntable`). ### Output | Field | Description | |-------|-------------| | `listing_id` | HifiShark internal ID (`_`) | | `title` | Listing title as shown on HifiShark | | `price` | Numeric price in the listing currency | | `currency` | ISO 4217 currency code (EUR, GBP, USD, etc.) | | `country` | Two-letter ISO country code of the source marketplace | | `source_site` | Name of the source marketplace (e.g., Audiogon, hifi-forsale) | | `source_listing_url` | Direct URL to the original listing | | `listing_image_url` | Primary listing image URL | | `listing_first_seen_at` | ISO 8601 timestamp when HifiShark first indexed this listing | | `hifishark_url` | HifiShark search URL that surfaced this listing | | `scraped_at` | ISO 8601 timestamp of when this record was scraped | | `condition` | Item condition if mentioned in the title (Mint, Excellent, Good, New, Used) | ### Use cases - **Price monitoring** — track market prices for specific models across all global marketplaces - **Arbitrage** — find price discrepancies between regions or platforms - **Inventory research** — check how many units of a specific model are currently for sale - **Brand monitoring** — monitor all listings for a manufacturer's product line - **AI pricing tools** — feed cross-marketplace pricing data into ML models ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `queries` | array | Yes | List of search terms. Each term fetches up to 48 listings. | | `maxItems` | integer | No | Maximum total records to return. Set to 0 for unlimited. | #### Example input ```json { "queries": ["Marantz PM-10", "McIntosh MC275", "Naim Nait", "Linn LP12"], "maxItems": 200 } ```` ### Notes - Each search query returns the **most recent** 48 listings. Use HifiShark's price history pages for historical data. - `manufacturer`, `model`, and `category` fields are always `null` in the output — they are not present in the search card. Derive these from the `title` field. - `/goto/` source URLs are HifiShark-tracked redirects. Direct URLs are used when available. - Site respects a `crawl-delay: 2` in robots.txt — the actor uses concurrency of 3 to stay polite. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `queries` (type: `array`): List of search terms to scrape (e.g. \["Marantz PM-10", "McIntosh MC275", "Naim Nait"]). Each query returns up to 48 current listings from across 600+ marketplaces. ## `maxItems` (type: `integer`): Maximum number of listing records to return across all queries. Set to 0 for unlimited. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "queries": [ "Marantz PM-10", "McIntosh MC275" ], "maxItems": 10 } ``` # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "queries": [ "Marantz PM-10", "McIntosh MC275" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/hifishark-used-hifi-listing-aggregator-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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "queries": [ "Marantz PM-10", "McIntosh MC275", ], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/hifishark-used-hifi-listing-aggregator-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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "queries": [ "Marantz PM-10", "McIntosh MC275" ], "maxItems": 10 }' | apify call jungle_synthesizer/hifishark-used-hifi-listing-aggregator-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/hifishark-used-hifi-listing-aggregator-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HifiShark Used Hifi Listing Aggregator Scraper", "description": "Scrape used hi-fi listings from HifiShark.com — the meta-search engine covering 600+ second-hand audio marketplaces. Search by keyword and extract price, source site, country, and direct listing URLs across Audiogon, USAudioMart, eBay, and 600+ other sources in a single run.", "version": "0.1", "x-build-id": "8Rv7xQsUlOdkjTYrN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~hifishark-used-hifi-listing-aggregator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-hifishark-used-hifi-listing-aggregator-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/jungle_synthesizer~hifishark-used-hifi-listing-aggregator-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-hifishark-used-hifi-listing-aggregator-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/jungle_synthesizer~hifishark-used-hifi-listing-aggregator-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-hifishark-used-hifi-listing-aggregator-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", "required": [ "queries" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "queries": { "title": "Search Queries", "type": "array", "description": "List of search terms to scrape (e.g. [\"Marantz PM-10\", \"McIntosh MC275\", \"Naim Nait\"]). Each query returns up to 48 current listings from across 600+ marketplaces.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of listing records to return across all queries. Set to 0 for unlimited." } } }, "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 } } } } } } } } } } ```