# Bonanza Marketplace Scraper (`getascraper/bonanza-marketplace-scraper`) Actor

Extract active Bonanza listings with prices, seller ratings, shipping details, and item specifics at scale. Supports keyword search, category browse, booth crawls, and deep detail enrichment.

- **URL**: https://apify.com/getascraper/bonanza-marketplace-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.31 / 1,000 marketplace listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Bonanza marketplace scraper: listings, prices, seller ratings, and booth inventory

Get Bonanza marketplace listings, prices, conditions, and seller ratings, ready for your spreadsheet in under 60 seconds.

---

### What does Bonanza marketplace scraper do?

Bonanza marketplace scraper extracts active listings from Bonanza across four scraping modes: keyword search, category browse, recently listed items, and full seller booth walks.

In its default mode, each listing row includes the item title, current USD price, condition, seller username, store name, shipping cost, shipping type, and a direct link to the product page. With the optional deep enrichment toggle enabled, each row expands with brand, UPC barcode, model number, stock quantity, full item description, seller feedback percentage and score, store item count, booth discount thresholds, ship-to locations, and all uploaded product images.

Every result is a flat, deduplicated row ready to drop into Excel, Airtable, or a Google Sheet. No login, no API keys, and no manual clicking required.

---

### Who uses this scraper?

* **I am a collectibles reseller** hunting under-priced vintage watches, trading cards, and antiques on Bonanza to flip on eBay or Etsy, and I need a daily price feed sorted cheapest first to catch fresh bargains before they sell.
* **I am a deal aggregator site owner** surfacing the lowest-priced Bonanza listings to my audience and need a structured dataset I can refresh nightly and publish as a searchable bargain board.
* **I am a competitive intelligence analyst** walking a rival seller's booth to audit their full catalog, pricing strategy, and stock quantities so my brand can undercut or match strategically.
* **I am a market researcher** monitoring recently listed collectibles in a specific category to spot emerging trends in niche secondhand markets.

---

### How to use this scraper

1. **Pick a mode**: choose keyword search, category browse, recently listed, or booth walk from the Mode dropdown.
2. **Set your filters**: enter a keyword, a numeric Bonanza category ID, or a seller booth username depending on the mode.
3. **Tune the filters**: apply price range, condition, free shipping, and seller feedback thresholds to narrow results.
4. **Enable enrichment** (optional): turn on "Fetch deep listing details" to add brand, UPC, model, quantity, and full seller profile to every row.
5. **Run and export**: click Run and download your dataset as CSV, Excel, or JSON from the dataset tab.

---

### Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `mode` | enum | No | Which scraping entry point to use: keyword search, category browse, recently listed items, or seller booth walk. Defaults to keyword search. |
| `keywords` | string | No | The search phrase to query on Bonanza. Active in keyword search and recently listed modes. Defaults to "vintage watch". |
| `categoryId` | string | No | Numeric Bonanza category ID for category browse mode, for example 4196 for Jewelry and Watches. Required only when mode is set to Browse Category. |
| `boothId` | string | No | Username of the seller's booth to walk, for example "cellularwholesales". Required only when mode is set to Booth Inventory Walk. |
| `sortOrder` | enum | No | How to order results: Best Match, highest price first, lowest price first, or most recently listed first. Defaults to Best Match. |
| `minPrice` | number | No | Minimum listing price in USD. Items below this price are excluded. Defaults to 0. |
| `maxPrice` | number | No | Maximum listing price in USD. Items above this price are excluded. Defaults to 10,000. |
| `conditionFilter` | enum | No | Restrict results to a specific item condition: any, new only, used only, or refurbished only. Defaults to any condition. |
| `freeShippingOnly` | boolean | No | When enabled, returns only listings that offer free shipping. Defaults to false. |
| `minSellerFeedback` | integer | No | Minimum positive seller feedback percentage required. Sellers below this threshold are filtered out. Defaults to 0 (no filter). |
| `excludeSoldOut` | boolean | No | When enabled, skips sold and unavailable items from the results. Defaults to false. |
| `scrapeDetails` | boolean | No | When enabled, visits each listing page to extract brand, UPC, model, quantity, description, and full seller details. Slower but richer. Defaults to false. |
| `maxItems` | integer | No | Maximum number of listing records to collect per run. Defaults to 100. |
| `proxyConfiguration` | object | Yes | Proxy settings for connection routing. Residential proxies are required because Bonanza blocks datacenter IP addresses. |

---

### Data table

Each row returned contains the following fields. Fields marked with an asterisk (`*`) are only present when "Fetch deep listing details" is enabled.

| Field | Type | Description |
| --- | --- | --- |
| `item_id` | string | Unique Bonanza product identifier. |
| `title` | string | Full name of the listed item as shown on Bonanza. |
| `price` | number | Current selling price of the item in USD. |
| `currency` | string | Currency code, typically USD. |
| `condition` | string | Physical condition of the item: NewCondition, UsedCondition, or Refurbished. |
| `seller_username` | string | Unique username of the item's seller. |
| `store_name` | string | Display name of the seller's booth store. |
| `store_url` | string | Direct URL to the seller's booth storefront. |
| `shipping_cost` | number | Standard shipping cost in USD. Zero when shipping is free. |
| `shipping_type` | string | Shipping pricing method: Flat, Calculated, or Free. |
| `image_url` | string | Main product thumbnail image link. |
| `view_item_url` | string | Direct URL to the product listing page. |
| `scraped_at` | string | ISO 8601 timestamp of when the record was extracted. |
| `seller_feedback_percent` * | number | Seller's positive feedback rating as a percentage, for example 99.4. |
| `seller_feedback_star` * | string | Visual feedback tier label assigned by Bonanza. |
| `seller_feedback_score` * | integer | Net positive feedback count on the seller's account. |
| `seller_membership` * | string | Bonanza membership level of the seller, for example Plus member. |
| `seller_chat_available` * | boolean | True if the seller is currently online and available to chat. |
| `store_item_count` * | integer | Total number of active listings in the seller's store. |
| `store_discount_percent` * | integer | Percentage discount available on purchases in this booth. |
| `store_discount_threshold` * | number | Minimum spend in USD required to unlock the booth discount. |
| `picture_urls` * | array of strings | All product image links uploaded by the seller. |
| `sku` * | string | Stock keeping unit code specified by the seller. |
| `upc` * | string | Universal Product Code or barcode identifier for the item. |
| `brand` * | string | Brand or manufacturer label extracted from the listing. |
| `model` * | string | Specific model name or style code of the item. |
| `quantity_available` * | integer | Total quantity the seller has in stock and available to buy. |
| `description` * | string | Clean product description snippet, up to 1,000 characters. |
| `ship_to_locations` * | array of strings | Countries and regions the seller ships to. |
| `location` * | string | City and state where the item is located. |
| `country` * | string | Two-letter ISO country code of the item's location. |
| `postal_code` * | string | Postal or ZIP code of the item's location. |

#### Sample output record

```json
{
  "item_id": "1036484728",
  "title": "Vintage Seiko 5 Automatic Men's Watch SNK809K2 Stainless Steel Black Dial",
  "price": 85.00,
  "currency": "USD",
  "condition": "UsedCondition",
  "seller_username": "timelesswatchco",
  "seller_feedback_percent": 99.8,
  "seller_feedback_star": "Turquoise",
  "seller_membership": "Plus member",
  "store_name": "Timeless Watch Co",
  "store_url": "https://www.bonanza.com/booths/timelesswatchco",
  "store_item_count": 247,
  "shipping_cost": 0.00,
  "shipping_type": "Free",
  "image_url": "https://d2ybmb80bbm9ts.cloudfront.net/afu/images/1036/4847/BonanzaItem1036484728_rt.JPEG",
  "picture_urls": [
    "https://d2ybmb80bbm9ts.cloudfront.net/afu/images/1036/4847/BonanzaItem1036484728_rt.JPEG",
    "https://d2ybmb80bbm9ts.cloudfront.net/afu/images/1036/4847/BonanzaItem1036484728_side.JPEG"
  ],
  "view_item_url": "https://www.bonanza.com/listings/vintage-seiko-5-automatic/1036484728",
  "sku": "SEIKO-SNK809K2-BLK",
  "upc": "029665169082",
  "brand": "Seiko",
  "model": "SNK809K2",
  "quantity_available": 2,
  "description": "Authentic Seiko 5 Automatic 21-jewel movement. Black dial with day-date window at 3 o'clock. Stainless steel case and bracelet. Water resistant to 30m. Original box included. Excellent pre-owned condition.",
  "seller_feedback_score": 4821,
  "seller_chat_available": false,
  "store_discount_percent": 10,
  "store_discount_threshold": 100.00,
  "ship_to_locations": ["United States", "Canada", "United Kingdom", "Australia"],
  "country": "US",
  "postal_code": "90210",
  "location": "Beverly Hills, California",
  "scraped_at": "2026-06-26T08:30:00.000Z"
}
````

***

### Pricing

Pricing is pay per result and is billed per row successfully saved to your dataset. Empty runs cost nothing.

There are no fixed monthly subscriptions or hidden maintenance fees. You pay only for the records you actually collect.

***

### FAQ

##### Does this scraper get blocked by Bonanza?

Bonanza blocks datacenter IP addresses at the network edge. This scraper routes all requests through Apify Residential proxies by default, which use real household IP addresses and rotate automatically to avoid detection. The built-in session pool and request delays further reduce block rates. For very large runs, keeping the default residential proxy setting is strongly recommended.

##### Does it access private seller accounts or login-required pages?

No. This scraper reads only publicly visible listing pages and booth storefronts that any visitor can see without logging in. It does not access seller dashboards, transaction histories, private messages, or any authentication-gated content.

##### How fresh is the data?

Each run fetches live pages directly from Bonanza at the moment of execution. Prices, stock quantities, and listing statuses reflect what is currently visible on the site. There is no caching or stored data. Scheduling a daily run keeps your dataset current without any manual work.

##### Which scraping modes does the actor support?

The scraper supports four modes: keyword search (returns results for any search phrase), category browse (walks a specific Bonanza category by numeric ID), recently listed (returns the newest listings for a keyword, useful for new-arrival monitoring), and booth inventory walk (exports every active listing inside a named seller's storefront). All four modes produce the same flat output schema.

# Actor input Schema

## `mode` (type: `string`):

Select what to scrape from Bonanza: keyword directory search, category browse catalogs, recently listed products, or seller booth storefronts.

## `keywords` (type: `string`):

Query keywords to search for items across Bonanza. Only applicable in 'Search by Keyword' and 'Recently Listed Watcher' modes.

## `categoryId` (type: `string`):

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.

## `boothId` (type: `string`):

The username or slug of a specific seller's booth to walk (e.g. 'cellularwholesales'). Only applicable in 'Booth Inventory Walk' mode.

## `sortOrder` (type: `string`):

Specify how output results are sorted (Best Match, Price, or Start Time).

## `minPrice` (type: `number`):

Filter results to only include items with a price greater than or equal to this value in USD.

## `maxPrice` (type: `number`):

Filter results to only include items with a price less than or equal to this value in USD.

## `conditionFilter` (type: `string`):

Filter items strictly by physical condition type.

## `freeShippingOnly` (type: `boolean`):

If enabled, filters results to only include items that have free shipping.

## `minSellerFeedback` (type: `integer`):

Filter out listings from sellers with a positive feedback rating below this percentage.

## `excludeSoldOut` (type: `boolean`):

If enabled, filters out items that are sold or no longer available for sale.

## `scrapeDetails` (type: `boolean`):

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.

## `maxItems` (type: `integer`):

Maximum total item records to extract during this crawl run.

## `proxyConfiguration` (type: `object`):

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.

## Actor input object example

```json
{
  "mode": "search_keywords",
  "keywords": "vintage watch",
  "categoryId": "",
  "boothId": "",
  "sortOrder": "BestMatch",
  "minPrice": 0,
  "maxPrice": 10000,
  "conditionFilter": "any",
  "freeShippingOnly": false,
  "minSellerFeedback": 0,
  "excludeSoldOut": false,
  "scrapeDetails": false,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `keyValueStore` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search_keywords",
    "keywords": "vintage watch",
    "categoryId": "",
    "boothId": "",
    "sortOrder": "BestMatch",
    "minPrice": 0,
    "maxPrice": 10000,
    "conditionFilter": "any",
    "freeShippingOnly": false,
    "minSellerFeedback": 0,
    "excludeSoldOut": false,
    "scrapeDetails": false,
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/bonanza-marketplace-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search_keywords",
    "keywords": "vintage watch",
    "categoryId": "",
    "boothId": "",
    "sortOrder": "BestMatch",
    "minPrice": 0,
    "maxPrice": 10000,
    "conditionFilter": "any",
    "freeShippingOnly": False,
    "minSellerFeedback": 0,
    "excludeSoldOut": False,
    "scrapeDetails": False,
    "maxItems": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/bonanza-marketplace-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search_keywords",
  "keywords": "vintage watch",
  "categoryId": "",
  "boothId": "",
  "sortOrder": "BestMatch",
  "minPrice": 0,
  "maxPrice": 10000,
  "conditionFilter": "any",
  "freeShippingOnly": false,
  "minSellerFeedback": 0,
  "excludeSoldOut": false,
  "scrapeDetails": false,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call getascraper/bonanza-marketplace-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getascraper/bonanza-marketplace-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Bonanza Marketplace Scraper",
        "description": "Extract active Bonanza listings with prices, seller ratings, shipping details, and item specifics at scale. Supports keyword search, category browse, booth crawls, and deep detail enrichment.",
        "version": "0.1",
        "x-build-id": "tYRWneWkv5JKjPihU"
    },
    "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": 100
                    },
                    "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
