{ "openapi": "3.0.1", "info": { "title": "Guitar Center Scraper", "description": "Scrape Guitar Center's musical instrument catalog. Browse by department (guitars, amps, drums, keyboards, and more), New Arrivals, Deals, or Used Gear. Get price, brand, condition, ratings, stock, and full product details.", "version": "1.0", "x-build-id": "dXZjUyWRDRfus7T7h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~guitar-center-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-guitar-center-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~guitar-center-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-guitar-center-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~guitar-center-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-guitar-center-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": [ "browse", "search", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "browse" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword search, e.g. `Fender Player`, `reverb pedal`, `Ludwig snare`. Guitar Center's search endpoint returns a single results page (up to ~24-45 best matches depending on match quality) — it does not support paging through the full result set." }, "category": { "title": "Category (mode=browse)", "enum": [ "Guitars", "Amps & Effects", "Keyboards & MIDI", "Drums & Percussion", "DJ Equipment", "Bass", "Recording Gear", "Live Sound", "Accessories", "Microphones & Wireless", "Music Software", "Lighting & Stage Effects", "Band & Orchestra", "New Arrivals", "All Deals", "Used Gear", "Daily Pick" ], "type": "string", "description": "Department or special section to browse.", "default": "Guitars" }, "productUrls": { "title": "Product URLs (mode=byUrl)", "type": "array", "description": "Exact Guitar Center product page URLs, e.g. `https://www.guitarcenter.com/Ibanez/GRX70QA-Electric-Guitar-Transparent-Blue-Burst-1313248770709.gc`.", "default": [], "items": { "type": "string" } }, "brand": { "title": "Brand", "type": "string", "description": "Filter to an exact brand name (e.g. `Fender`, `Ibanez`, `Yamaha`). Case-insensitive exact match." }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced below this." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced above this." }, "condition": { "title": "Condition", "enum": [ "", "New", "Used" ], "type": "string", "description": "Filter to New or Used items.", "default": "" }, "conditionGrade": { "title": "Used condition grade", "enum": [ "", "Excellent", "Great", "Good", "Fair", "Poor" ], "type": "string", "description": "Filter Used items to a specific grade.", "default": "" }, "minRating": { "title": "Min rating (0-10)", "minimum": 0, "maximum": 10, "type": "integer", "description": "Drop products with an average review rating below this (Guitar Center rates out of 10)." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "ratingDesc", "nameAsc" ], "type": "string", "description": "Sort order applied to the fetched batch of results (the site does not support server-side sorting via URL, so this re-orders what was collected in this run).", "default": "relevance" }, "fetchFullDetails": { "title": "Fetch full details", "type": "boolean", "description": "For mode=browse: fetch each product's detail page for description, features, specifications, breadcrumb categories, and full-size images. Uses 1 extra request per product; disable for a faster, lighter run. Always on for mode=byUrl.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "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 } } } } } } } } } }