{ "openapi": "3.0.1", "info": { "title": "Reverb Instrument Marketplace Scraper", "description": "Extract listings, prices, brands, conditions & seller ratings from Reverb.com — the world's largest used music gear marketplace. Keyword search, bulk extraction, price filtering & automatic pagination. API-based, no browser needed.", "version": "1.0", "x-build-id": "IveUUxr4U6PeTUHkC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~reverb-instrument-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-reverb-instrument-marketplace-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/logiover~reverb-instrument-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-logiover-reverb-instrument-marketplace-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/logiover~reverb-instrument-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-reverb-instrument-marketplace-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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Keywords to search for on Reverb.com. Each query fetches paginated results from the Reverb API (24 listings per page) until the max listings limit is reached. Examples: 'fender stratocaster', 'gibson les paul', 'roland jupiter 8', 'vintage moog'. Multiple queries can be combined — results are saved sequentially.", "items": { "type": "string" } }, "startUrls": { "title": "Reverb Search URLs", "type": "array", "description": "Reverb.com marketplace search URLs to scrape. The scraper extracts the search query from the URL automatically. Supported format: reverb.com/marketplace?query=fender+stratocaster. Additional filters in the URL (condition, price range) are not parsed — use the input fields below for filtering.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxListings": { "title": "Max Listings Per Query", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to save per search query or URL. The scraper paginates automatically (24 listings per page) until this limit is reached. Set to 0 for unlimited results. Note: popular searches can return thousands of listings.", "default": 50 }, "condition": { "title": "Filter by Condition", "enum": [ "all", "mint", "excellent", "very-good", "good", "fair", "poor", "non-functioning" ], "type": "string", "description": "Filter listings to a specific item condition. 'Mint' means essentially new and unplayed. 'Excellent' shows light cosmetic wear. 'Very Good' has minor signs of use. Conditions below 'Good' indicate visible wear or functional issues. Leave as 'All Conditions' to return listings of every condition.", "default": "all" }, "minPrice": { "title": "Minimum Price (USD)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or above this amount in USD. Leave empty to include listings of any price. Can be combined with Maximum Price to define a price range." }, "maxPrice": { "title": "Maximum Price (USD)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or below this amount in USD. Leave empty to include listings of any price. Can be combined with Minimum Price to define a price range." }, "proxyConfiguration": { "title": "Proxy Settings", "type": "object", "description": "Proxy settings for requests to the Reverb API. The default Apify proxy works for most runs. Switch to residential proxies if you encounter rate limiting or access blocks.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }