{ "openapi": "3.0.1", "info": { "title": "Sam Ash Music Scraper", "description": "Scrape Sam Ash Music (samash.com) - search or browse musical instruments and gear by category, brand, price, and stock status, or look up exact products by SKU. Returns price, brand, stock status, sale badges, images, and product URLs.", "version": "1.0", "x-build-id": "RqX6zgTCxnfsXhQ2s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~sam-ash-music-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-sam-ash-music-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/crawlerbros~sam-ash-music-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-sam-ash-music-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/crawlerbros~sam-ash-music-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-sam-ash-music-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "bySkus" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword search (mode=search). Leave empty to browse the catalog / a category using only the filters below.", "default": "" }, "category": { "title": "Category (mode=search)", "enum": [ "", "Guitars", "Bass Guitars", "Drums & Percussion", "Live Sound & Lighting", "Microphones and Wireless Systems", "Recording", "Band and Orchestra", "Pianos & Keyboards", "Cables", "DJ & Production", "DJ", "Music Education & Gifts", "Used Musical Instruments", "Sale", "Samson iPhone/Android Microphones" ], "type": "string", "description": "Restrict results to a top-level department/category.", "default": "" }, "brand": { "title": "Brand (mode=search)", "enum": [ "", "Yamaha", "Remo", "D'Addario", "Evans", "Vic Firth", "Samson", "Latin Percussion", "On-Stage", "Gator", "Gibson", "Roland", "Zildjian", "Boss", "Hosa", "Drum Workshop", "Dunlop", "Shure", "Aquarian", "Gibraltar", "Martin", "Promark", "D.A.S. Audio", "Epiphone", "Mackie", "Paiste", "RapcoHorizon", "Taylor", "Tama", "Vater", "PDP", "Sennheiser", "Electro-Voice", "Sabian", "Hohner", "Ludwig", "Ernie Ball", "SE Electronics", "Hercules", "Warm Audio", "Mapex", "Vandoren", "Lanikai", "Casio", "JBL", "AKG", "Presonus", "Universal Audio", "Carlo Robelli", "Washburn", "Nux", "Tourtek", "Ahead", "ESP", "Kawai", "Telefunken USA", "Allen & Heath", "beyerdynamic", "Chauvet DJ", "Levy's", "Gemini", "Jean Baptiste", "Michael Kelly", "Electro-Harmonix", "Rico", "Ahead Armor Cases", "IK Multimedia", "Alto", "MXL", "Marshall", "Orange Amplification", "Hartke", "Line 6", "Planet Waves", "Takamine", "Nord", "Arturia", "Focusrite", "Legere", "Zoom", "MXR", "Rhythm Tech", "Blizzard", "Fishman", "H. Jimenez", "Novation", "DigiTech", "HK Audio", "La Bella", "Fender", "TASCAM", "Behringer", "Big Fat Snare Drum", "Focal", "M-Audio", "Soundcraft", "Adam Audio", "Proco", "Sonor", "Cordoba", "Cympad", "Low Boy", "Protection Racket", "Toca", "Decksaver", "Kohala", "Reloop", "Super Sensitive", "Guild", "Headliner", "ALLPARTS", "Alesis", "PureSound", "Sequential", "Slingerland", "Solid State Logic", "dbx", "Akai", "DR Strings", "Neutrik", "Oscar Schmidt", "MusicNomad", "Avantone Pro", "Black Lion Audio", "KRK", "National", "Neumann", "Pinnacle Microphones", "Rocknroller", "Sontronics", "Efnote", "Jet", "Jodi Head", "Numark", "Otto Link", "Sam Ash", "Bach", "Canopus", "ColorKey", "Crown", "Drum N Base", "Ibanez", "MOTU", "Moog Music", "Morley", "RTOM", "Rovner", "Selmer", "Thomastik", "Ampeg", "Quik-Lok", "Third Man Hardware", "American DJ", "Benjamin Adams", "Cloud Microphones", "Elixir", "Gretsch", "KNA", "Kramer", "Native Instruments", "ART", "FAXX", "Heritage Audio", "K&M", "Kala", "Lee Oskar", "Maestro", "P. Mauriat", "Pirastro", "Saramonic", "Studiologic", "TC Electronic", "Walrus Audio", "Aquila", "Bad Cat", "Danmar Percussion", "Dexibell", "EVE Audio", "G7th", "Golden Age Audio", "Jackson", "Jones", "Kun", "Kyser", "M-Live", "Tackle Instrument Supply Co.", "Auralex", "Barcus Berry", "Ecler", "Harmon", "Hetman", "Hughes & Kettner", "KAT", "Manhasset", "Pickboy", "Rane", "Strymon", "Aston Microphones", "Avid", "Boomwhackers", "GHS", "Hotone", "Howard Core", "Jasmine", "Jo Ral", "Jupiter", "Kurzweil", "Lock-It Straps", "Meinl Percussion", "Oberheim", "Rogers", "Spectrasonics", "Tech 21", "Trophy", "Ultimate Support", "Yorkville", "AER", "Aim Music", "AirTurn", "Antelope Audio", "Bass Drum Os", "CAIG", "Chedeville", "Crane", "CruzTOOLS", "DOD", "Denon", "Dorfler", "F.R. Pfretszchner", "Goby Labs", "Hal Leonard", "Hill", "IA Stands", "ISOVOX", "Ingles", "J & D Hite", "Joe Co.", "KickPort", "Meinl Cymbals", "Meyer", "Pioneer DJ", "Prelude by Selmer", "Rhythm Band", "Schecter", "Seiko", "Sheeran", "SoundSwitch", "Switchcraft", "Torso Electronics", "Twin Cities Drum Collective", "Way Huge", "Xeros", "iCON", "Alhambra", "American Recorder", "Apogee", "Artino", "Audio-Technica", "BBE", "Benro", "Blackstar", "Blitz", "Blue Juice", "Buckle-Down", "CAD", "CB Percussion", "Charvel", "ChordSavers", "Cort", "Crossrock", "Darco", "Deg", "Divitone", "Drum Dial", "EVH", "Eliminator Lighting", "Evermix", "Flix", "Gallien-Krueger", "Gon Bops", "Graph Tech", "Gruv Gear", "Jico", "Kelly Shu", "KickBlock", "KickPro", "Korg", "Larsen Strings", "Legacy", "Lindell Audio", "MEE audio", "Majestic Percussion", "Matrix", "Metrophones", "Mutec", "Oasis", "PRS", "Parduba", "Phil Jones Bass", "Playonair", "Powell", "Primacoustic", "Protec", "Resonans", "Robinson’s Remedies", "Savarez", "Singular Sound", "Slate", "Snark", "Spira", "Stage Ninja", "Stagg", "Sterisol", "Strukture", "Super Slick", "Suzuki", "Theo Wanne", "Tom Crown", "TreeWorks", "Valeton", "Wolf", "X-Percussion", "Zonda", "Zylia" ], "type": "string", "description": "Restrict results to an exact brand/manufacturer.", "default": "" }, "condition": { "title": "Condition (mode=search)", "enum": [ "", "New", "Used", "Open Box", "B-Stock", "Demo" ], "type": "string", "description": "Restrict results to an exact product condition.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "popularity", "priceLowToHigh", "priceHighToLow", "newest", "bestSelling" ], "type": "string", "description": "Result ordering (mode=search).", "default": "relevance" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced below this amount." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced above this amount." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only emit products currently marked in stock.", "default": false }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only emit products currently marked on sale.", "default": false }, "newArrivalsOnly": { "title": "New arrivals only", "type": "boolean", "description": "Only emit products marked as new arrivals.", "default": false }, "priceDropOnly": { "title": "Price drops only", "type": "boolean", "description": "Only emit products currently marked with a recent price drop (distinct from `onSaleOnly` — a product can have a price drop without being flagged as an official sale item).", "default": false }, "skus": { "title": "SKUs / model numbers (mode=bySkus)", "type": "array", "description": "Exact Sam Ash SKUs or manufacturer model numbers, e.g. `GES35500N`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 } } }, "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 } } } } } } } } } }