{ "openapi": "3.0.1", "info": { "title": "Bonanza Marketplace Scraper: Listings, Prices & Seller Ratings", "description": "Extract active Bonanza listings by keyword, category, recently listed, or seller booth walk. Get price, condition, shipping, and seller name for every item, plus optional feedback score, brand, UPC, and stock details. Export to CSV, JSON, or Excel. No login needed. $1.75 per 1,000 results.", "version": "0.3", "x-build-id": "W0BHDITe7cHWSkXd6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~bonanza-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-bonanza-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/getascraper~bonanza-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-bonanza-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/getascraper~bonanza-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-bonanza-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", "required": [ "proxyConfiguration" ], "properties": { "mode": { "title": "Scraping Mode", "enum": [ "search_keywords", "browse_category", "recently_listed", "booth_inventory" ], "type": "string", "description": "Select what to scrape from Bonanza: keyword directory search, category browse catalogs, recently listed products, or seller booth storefronts.", "default": "search_keywords" }, "keywords": { "title": "Search Keywords", "type": "string", "description": "Query keywords to search for items across Bonanza. Only applicable in 'Search by Keyword' and 'Recently Listed Watcher' modes.", "default": "vintage watch" }, "categoryId": { "title": "Category ID", "type": "string", "description": "Scrape items from a specific Bonanza numeric Category ID (e.g. 4196 for Jewelry & Watches, 99 for Antiques & Collectibles). Only applicable in 'Browse Category' mode.", "default": "" }, "boothId": { "title": "Seller Booth ID", "type": "string", "description": "The username or slug of a specific seller's booth to walk (e.g. 'cellularwholesales'). Only applicable in 'Booth Inventory Walk' mode.", "default": "" }, "sortOrder": { "title": "Sort Order", "enum": [ "BestMatch", "CurrentPriceHighest", "CurrentPriceLowest", "StartTimeNewest" ], "type": "string", "description": "Specify how output results are sorted (Best Match, Price, or Start Time).", "default": "BestMatch" }, "minPrice": { "title": "Minimum Price (USD)", "minimum": 0, "type": "number", "description": "Filter results to only include items with a price greater than or equal to this value in USD.", "default": 0 }, "maxPrice": { "title": "Maximum Price (USD)", "minimum": 0, "type": "number", "description": "Filter results to only include items with a price less than or equal to this value in USD.", "default": 10000 }, "conditionFilter": { "title": "Condition Filter", "enum": [ "any", "NewCondition", "UsedCondition", "Refurbished" ], "type": "string", "description": "Filter items strictly by physical condition type.", "default": "any" }, "freeShippingOnly": { "title": "Free Shipping Only", "type": "boolean", "description": "If enabled, filters results to only include items that have free shipping.", "default": false }, "minSellerFeedback": { "title": "Minimum Seller Feedback %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Filter out listings from sellers with a positive feedback rating below this percentage.", "default": 0 }, "excludeSoldOut": { "title": "Exclude Sold Out Items", "type": "boolean", "description": "If enabled, filters out items that are sold or no longer available for sale.", "default": false }, "scrapeDetails": { "title": "Fetch Deep Listing Details", "type": "boolean", "description": "If enabled, navigates to each product detail page to extract UPC, brand, model, quantities, and descriptions. Leaving this disabled is 10x faster and 100% block-proof.", "default": false }, "maxItems": { "title": "Maximum Listings Limit", "minimum": 1, "type": "integer", "description": "Maximum total item records to extract during this crawl run.", "default": 30 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for connection routing. Datacenter proxies (the default) work reliably because Cloudflare bypass is handled by the real browser fingerprint, not IP quality. Switch to Residential only if a very large run hits rate limits.", "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 } } } } } } } } } }