{ "openapi": "3.0.1", "info": { "title": "Reverb Used Gear New Listings & Deal Alert", "description": "Newest Reverb used music gear listings for any search terms, one flat row each: title, price in USD, condition, shop, make, model, year, finish, category, photo, shipping, price drop, URL. Newest-first or by price, with condition and price filters.", "version": "0.1", "x-build-id": "kZ9oWCQIO3L58ghqS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~reverb-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-reverb-listings", "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/superslowsloth~reverb-listings/runs": { "post": { "operationId": "runs-sync-superslowsloth-reverb-listings", "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/superslowsloth~reverb-listings/run-sync": { "post": { "operationId": "run-sync-superslowsloth-reverb-listings", "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": { "queries": { "title": "Search terms", "type": "array", "description": "What you would type into Reverb's search box, one term per line (for example fender telecaster, boss ds-1 or moog subharmonicon). Each term is searched and read separately. A listing that two terms both find is returned once, under the first.", "items": { "type": "string" } }, "maxItems": { "title": "Max listings per search term", "minimum": 1, "maximum": 2500, "type": "integer", "description": "Read at most this many listings for each search term. Reverb serves 50 per request and never more than 50 pages (2,500 listings) per search, however many it reports finding, so values above 2500 are not accepted.", "default": 100 }, "sort": { "title": "Sort order", "enum": [ "newest", "relevance", "price-asc", "price-desc" ], "type": "string", "description": "The order Reverb lists the results in. 'Newest first' orders by publication time and is the one for new-listing alerts. 'Relevance' is Reverb's own default order. The price sorts follow Reverb's own price ordering, so a listing converted from another currency can sit slightly out of dollar order.", "default": "newest" }, "conditions": { "title": "Condition", "type": "array", "description": "Only listings in one of these conditions. Leave empty for every condition. 'Used (all grades)' is Reverb's own umbrella for mint, excellent, very good, good and fair; it excludes brand new and B-stock.", "items": { "type": "string", "enum": [ "new", "used", "mint", "excellent", "very-good", "good", "fair", "non-functioning", "b-stock" ], "enumTitles": [ "Brand new", "Used (all grades)", "Mint", "Excellent", "Very good", "Good", "Fair", "Non-functioning", "B-stock" ] } }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "number", "description": "Lowest asking price to return, in US dollars, inclusive. Leave empty for no lower bound. Reverb converts listings priced in other currencies to dollars itself, so a row can land a fraction of a percent outside the band." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "number", "description": "Highest asking price to return, in US dollars, inclusive. Leave empty for no upper bound. Use it, with a minimum, to read past the 2,500-listings-per-search window Reverb serves." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy (automatic datacenter exits) is the default. Reverb sits behind Cloudflare; a refused request (403, 429) is retried from a fresh address, which is what the proxy is for.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }