{ "openapi": "3.0.1", "info": { "title": "Reverb Music Gear and Sold Price Guide Scraper", "description": "Scrape reverb.com music gear: guitars, amps, synths, pedals, drums and pro audio. Search live listings by brand, category, condition, price, year, region and shipping, or paste links. Uniquely returns the sold Price Guide per gear model: median, low, high and quartile realised prices.", "version": "1.0", "x-build-id": "eS3YpBCvfgOzPWRyz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~reverb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-reverb-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/abotapi~reverb-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-reverb-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/abotapi~reverb-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-reverb-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", "price-guide", "url" ], "type": "string", "description": "Choose 'search' for keyword search across live listings with filters, 'price-guide' to look up gear models and their realised sale prices (median, range, per condition, over time), or 'url' to scrape pasted links.", "default": "search" }, "queries": { "title": "Search keywords", "type": "array", "description": "One or more keywords. In search mode each keyword returns live listings; in Price Guide mode each keyword returns matching gear models with their sold-price statistics. Examples: 'Fender Stratocaster', 'Moog Subsequent 37', 'Shure SM57'.", "default": [ "Fender Stratocaster" ], "items": { "type": "string" } }, "urls": { "title": "Reverb links or listing ids", "type": "array", "description": "Mix freely: item links (reverb.com/item/), Price Guide or product links (reverb.com/price-guide/ or reverb.com/p/), shop links (reverb.com/shop/), brand links (reverb.com/brand/), marketplace search links (reverb.com/marketplace?query=...), or bare listing ids. A link that is not one of these is reported and skipped rather than guessed at.", "default": [ "https://api.reverb.com/api/listings?query=stratocaster&condition=used&per_page=1", "https://api.reverb.com/api/listings?query=stratocaster&per_page=2&page=2", "https://reverb.com/brand/fender", "https://reverb.com/shop/lavonta-rashawns-boutique", "https://reverb.com/item/103425668", "https://api.reverb.com/api/csps?query=stratocaster&per_page=1", "https://api.reverb.com/api/comparison_shopping_pages/126164", "https://reverb.com/marketplace?query=Gibson%20Les%20Paul&condition=used", "https://reverb.com/price-guide/fender-american-professional-ii-stratocaster" ], "items": { "type": "string" } }, "make": { "title": "Brand", "type": "string", "description": "Only return gear from this brand, for example 'Fender', 'Gibson', 'Moog' or 'Shure'. The name is matched against the marketplace's own brand list (capitalisation does not matter); a brand that does not exist stops the run with a clear message instead of searching everything. Applies to search mode and Price Guide mode." }, "category": { "title": "Category", "type": "string", "description": "Only return gear in this category. Type a top-level category (accessories, acoustic-guitars, amps, band-and-orchestra, bass-guitars, dj-and-lighting-gear, drums-and-percussion, effects-and-pedals, electric-guitars, folk-instruments, home-audio, keyboards-and-synths, parts, pro-audio) or the name of any sub-category, for example 'Solid Body' or 'Electric Guitars / Solid Body'. A name shared by several categories (such as '12-String') must be typed with its full path. A category that does not exist stops the run with a clear message instead of searching everything. Applies to search mode and Price Guide mode. The source also relevance-matches nearby categories into its own results, so in search mode the actor additionally checks each listing's own top-level category and drops the ones that do not belong.", "default": "" }, "minYear": { "title": "Earliest year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only return gear made in this year or later. Applies to search mode and Price Guide mode. Useful with the latest year for vintage windows, for example 1950 to 1969." }, "maxYear": { "title": "Latest year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only return gear made in this year or earlier. Applies to search mode and Price Guide mode." }, "conditions": { "title": "Condition (search mode)", "type": "array", "description": "Only return listings in these conditions. Pick several to combine them. Search mode only. Note the source answers an unknown condition with the WHOLE catalogue rather than an error, so a value it does not recognise stops the run instead of quietly returning everything.", "items": { "type": "string", "enum": [ "new", "b-stock", "used", "mint", "excellent", "very-good", "good", "fair", "poor", "non-functioning" ], "enumTitles": [ "Brand New", "B-Stock", "Used (any)", "Mint", "Excellent", "Very Good", "Good", "Fair", "Poor", "Non Functioning" ] }, "default": [] }, "minPrice": { "title": "Minimum price (USD, search mode)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount, in US dollars. Search mode only. The window is also re-checked against each listing's reported US dollar price, because the source applies it to the seller's own currency." }, "maxPrice": { "title": "Maximum price (USD, search mode)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount, in US dollars. Search mode only. The window is also re-checked against each listing's reported US dollar price, because the source applies it to the seller's own currency." }, "itemRegion": { "title": "Seller country (search mode)", "enum": [ "", "US", "CA", "GB", "DE", "FR", "IT", "ES", "NL", "SE", "JP", "AU", "NZ", "MX", "BR" ], "type": "string", "description": "Only return listings whose seller is in this country. Search mode only.", "default": "" }, "shipsTo": { "title": "Ships to (search mode)", "enum": [ "", "US", "CA", "GB", "DE", "FR", "IT", "ES", "NL", "SE", "JP", "AU", "NZ", "MX", "BR" ], "type": "string", "description": "Only return listings the seller will ship to this country. Search mode only.", "default": "" }, "shopSlug": { "title": "Shop (search mode)", "type": "string", "description": "Only return listings from one shop, given as the shop handle in its address, for example 'guitar-sauce-italy' from reverb.com/shop/guitar-sauce-italy. Search mode only. To sweep a shop without setting a keyword, paste its shop link in URL mode instead." }, "handmadeOnly": { "title": "Handmade only (search mode)", "type": "boolean", "description": "Only return gear the seller has marked as handmade or custom built. Search mode only.", "default": false }, "freeShippingOnly": { "title": "Free shipping only (search mode)", "type": "boolean", "description": "Only return listings that ship free. Search mode only. A listing counts as free shipping when it quotes a zero rate to any destination it ships to.", "default": false }, "preferredSellersOnly": { "title": "Preferred sellers only (search mode)", "type": "boolean", "description": "Only return listings from sellers the marketplace has marked as preferred. Search mode only.", "default": false }, "sortBy": { "title": "Sort by (search mode)", "enum": [ "relevance", "price-asc", "price-desc", "newest" ], "type": "string", "description": "Ordering asked of the source for a keyword search. Search mode only. Only orderings the source actually honours are offered here.", "default": "relevance" }, "includeSoldPriceGuide": { "title": "Include the sold Price Guide", "type": "boolean", "description": "Attach what this gear has actually SOLD for: median, low, high, quartiles, a breakdown per condition, the average gap between asking and realised price, the recent individual sales, and a period-by-period history. In search and URL modes it also scores each live listing against that history (below market, at market, above market). Turn off for the cheapest run: Price Guide records then keep only the live-market snapshot (how many are listed used and new, and the lowest asking price).", "default": true }, "fetchDetails": { "title": "Read each listing's own item page", "type": "boolean", "description": "Adds view and watcher counts, seller location, shipping and return policies, barcode, videos and accepted payment methods to every listing. Off by default because the result page already carries title, brand, model, year, finish, condition, price, seller and photos. Turning on the Price Guide above reads the item page too, so switching this on as well costs nothing extra.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per Price Guide record", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Owner reviews (title, text, star rating, reviewer, date) attached to each Price Guide record as a reviews list, newest first. Set 0 to skip reviews. The ceiling of 1000 keeps one run bounded. Reviews add no charge of their own. In incremental mode the reviews list never decides UPDATED, so a changed review count or a failed review read does not create a billable row.", "default": 20 }, "maxItems": { "title": "Max results", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of results returned across the whole run. This is the run's cap, up to 1,000,000. Use 0 for the largest allowed run (1,000,000).", "default": 20 }, "maxPages": { "title": "Max pages per keyword or link", "minimum": 0, "type": "integer", "description": "Maximum result pages walked per keyword or link, at 50 results a page. 0 means no page limit: the run then stops only at Max results, or when the source runs out of results.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is recommended. Leave the default selected unless a run reports that requests were refused.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run id or dataset id to continue a large crawl without returning, or charging for, results already collected there. Use this after an interrupted run. For recurring daily monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns everything matching as NEW. Later runs compare every result against the last run (asking price, currency, condition, state and inventory, title, description, seller, shipping, photos and every other field of the record; price-guide statistics for Price Guide records) and return only NEW, UPDATED and REAPPEARED results, with an UPDATED row's changedFields naming what moved. Never compared: the scrape time, days on market, the views, watchers and offer-count counters, which tick on their own without a real change, and the reviews list of a Price Guide record (its read can fail or be limited, so it would bill rows for data that did not change); all of these stay in the rows. Time-zone offsets, the order of recent sales and the edge-of-window sold statistics (unless the model's sale count or latest sale date moved) are not counted as changes either. Use What counts as a change to compare price and availability only, and Ignore fields to exclude more. State is kept separately for each mode, keyword set and filter setup, so two different searches never mix.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to let the actor derive a key from the mode, keywords, links and filters." }, "emitUnchanged": { "title": "Emit unchanged results (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return results that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have, so leave it off unless you want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired results (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return results that were present in a previous run but are no longer found, marked EXPIRED, which is how a listing selling or being withdrawn shows up. Only produced once a run has fully scanned the tracked search, never when Max results capped it or Resume was used. This returns, and bills, extra rows.", "default": false }, "changeScope": { "title": "What counts as a change (incremental mode only)", "enum": [ "all", "priceAndStock" ], "type": "string", "description": "All fields (default): any change to the record, except the always-ignored counters, returns an UPDATED row. Price and availability only: only price (asking, buyer, original and drop percent), currency, listing state, live flag inventory and shipping-rate (per region) changes (for Price Guide records, the sold median and average, ask average, used and new low price and listing counts) return an UPDATED row; changes to titles, descriptions, photos, shipping or seller details never do.", "default": "all" }, "compactUpdates": { "title": "Compact update rows (incremental mode only)", "type": "boolean", "description": "Off by default. When on, UPDATED and EXPIRED rows are short: ids, url, title, current price and availability, plus priceChanges with the old and new value of each moved price or availability field and variantChanges with the old and new rate of each shipping-rate region that changed. NEW rows always carry the complete record. A compact row carries no item-page or sold Price Guide data, so the detail surcharge is not billed for it.", "default": false }, "expireAfterMissedScans": { "title": "Expire after N missed full scans (incremental mode only)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only used with Emit expired results. A result is marked EXPIRED only after it has been missing from this many complete scans in a row (default 1). Raise it (for example 3) so a listing that briefly drops out of the search is not reported as gone. A result that comes back resets the count. EXPIRED means the listing was not found again, it does not prove the listing sold or was withdrawn; use the state and inventory fields for availability.", "default": 1 }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Optional. Field names to exclude from UPDATED change detection, in addition to the built-in handling (scrape time, days on market, views, watchers and offer count never trigger an UPDATED). Use this if another field turns out to be noisy for your search, for example photos. Use a dotted name such as priceGuide.recentSales to ignore a key inside a nested field. The ignored fields still appear in every returned row.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API and Integrations, then select it here. Notion gets a rich page per item; other connectors get a best-effort write or digest. Leave empty to skip; this never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 }, "condition": { "title": "Condition (alias)", "type": "string", "description": "Alias of Conditions: a single condition (new, b-stock, used, non-functioning...)." }, "maxListings": { "title": "Max listings (alias)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Alias of Max items." }, "scrapeDetails": { "title": "Scrape details (alias)", "type": "boolean", "description": "Alias of Fetch details." }, "proxyConfiguration": { "title": "Proxy configuration (alias)", "type": "object", "description": "Alias of Proxy configuration." } } }, "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 } } } } } } } } } }