# Dewu (Poizon) Product Scraper — Sneaker Price & Search API (`sian.agency/dewu-poizon-product-scraper`) Actor

Search Dewu (Poizon), China's top sneaker, streetwear and luxury resale marketplace, by keyword and export clean product data: title, brand, category, min/max/activity prices, SKU IDs and sold counts. Bulk keyword input, JSON/CSV/Excel output for price monitoring and market research.

- **URL**: https://apify.com/sian.agency/dewu-poizon-product-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** E-commerce, Marketing, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $11.00 / 1,000 product search results

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

## Dewu (Poizon) Product Scraper — Sneaker Price & Search API 👟

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Taobao & Tmall Scraper](https://img.shields.io/badge/Store-Taobao%20%26%20Tmall-FF4F00)](https://apify.com/sian.agency/taobao-tmall-product-scraper?fpr=sian) [![JD.com Scraper](https://img.shields.io/badge/Store-JD.com-E1251B)](https://apify.com/sian.agency/jd-com-product-scraper?fpr=sian) [![1688 Wholesale Scraper](https://img.shields.io/badge/Store-1688%20Wholesale-FF6A00)](https://apify.com/sian.agency/alibaba-1688-wholesale-scraper?fpr=sian)

#### 🎉 The first structured Dewu (Poizon) price-intelligence scraper on Apify — search China's biggest sneaker, streetwear & luxury resale marketplace by keyword
##### Built for resellers, brand-monitoring teams and pricing-intelligence analysts who need clean China-side product prices

---

### 📋 Overview

**Dewu (Poizon, 得物) is the "StockX of China"** — the dominant authenticated marketplace for sneakers, streetwear, luxury goods and collectibles. This actor searches it by keyword and returns clean, structured product rows with normalized prices, brands, SKU IDs and sold-count demand signals — no account, no API key, no setup.

**Why professionals choose this scraper:**
- ✅ **Real China-side prices**: min, max, activity (promo) and original prices, normalized from fen to CNY — the columns a reseller actually needs
- ⚡ **Keyword search, instant results**: ~20+ relevance-ranked products per keyword in a single call
- 🎯 **Resale-grade fields**: brand, category, SKU/SPU IDs, product image, resale flag and human-readable sold count per row
- 💰 **Pay only for what you get**: per-product pricing — duplicates and errors are never charged
- 💎 **Watchlist sweeps**: search a whole brand roster (Jordan, Yeezy, Supreme, Rolex…) in one run with bulk keyword input
- ✨ **NEW**: bilingual keyword support — search in English or Chinese (e.g. `Nike` or `耐克`)

---

### ✨ Features

- 🔍 **Keyword Product Search**: find products fast by any brand, model or term
- 💴 **Normalized CNY Pricing**: min / max / activity / original prices, converted from raw fen
- 🏷️ **Brand & Category**: brand name, brand ID and category ID on every row
- 🆔 **SKU & SPU IDs**: stable identifiers for matching, tracking and joins
- 📈 **Demand Signal**: human-readable sold count ("63k+ buyers") per product
- ♻️ **Resale Flag**: spot products surfaced in the second-hand / resale section
- 🚀 **Bulk Watchlist**: single keyword, an array of keywords, or a keywords file URL
- 🧬 **Smart Dedup**: per-keyword deduplication so you never pay for the same product twice
- 📦 **Clean Exports**: JSON, CSV and Excel straight from the Apify dataset

---

### 🎬 Quick Start

Pick a keyword, run the actor, and get a clean table of products with prices. No login on the marketplace required.

```bash
curl -X POST "https://api.apify.com/v2/acts/sian.agency~dewu-poizon-product-scraper/runs?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"operation":"keywordSearch","keyword":"Air Jordan 1","maxResults":25}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Enter a keyword

Type a single keyword, or add a list of keywords for a bulk watchlist sweep.

#### Step 2: Run the actor

Start the run — it searches the marketplace and flattens the results into clean rows.

#### Step 3: Export your data

Download the dataset as JSON, CSV or Excel, or pull it via the API.

**That's it! In under a minute, you'll have:**

- A structured table of matching products
- Min / max / activity / original prices in CNY
- Brand, category, SKU IDs, images and sold counts

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| operation | string | No | Operation to run (`keywordSearch`) |
| keyword | string | No | A single search keyword |
| keywords | array | No | Multiple keywords for a bulk watchlist sweep |
| keywordsFileUrl | string | No | Public URL to a text file with one keyword per line |
| maxResults | integer | No | Max unique products per keyword (5–100, default 25) |

**Single keyword:**

```json
{
  "operation": "keywordSearch",
  "keyword": "Yeezy Boost 350",
  "maxResults": 25
}
```

**Bulk watchlist:**

```json
{
  "operation": "keywordSearch",
  "keywords": ["Air Jordan 1", "Yeezy Boost 350", "Supreme Box Logo", "Rolex Submariner"]
}
```

> ℹ️ FREE tier processes up to 5 keywords per run. PAID tier is unlimited.

***

### 📤 Output

Results are saved to the Apify dataset with **20+ fields** including:

| Field | Type | Description |
|-------|------|-------------|
| productTitle | string | Product name as listed |
| brandName | string | Brand (Nike, Jordan, adidas, Rolex…) |
| priceCny | number | Headline price in CNY |
| minSalePriceCny | number | Lowest sale price across variants (CNY) |
| maxSalePriceCny | number | Highest sale price across variants (CNY) |
| activityPriceCny | number | Promotional price if a campaign is active (CNY) |
| originPriceCny | number | Original / list price (CNY) |
| soldCountText | string | Human-readable demand signal |
| isSold | boolean | True if surfaced in the resale section |
| spuId / skuId | string | Product family & variant identifiers |
| categoryId | string | Marketplace category ID |
| logoUrl | string | Primary product image URL |

**Example:**

```json
{
  "productTitle": "Jordan Air Jordan 1 \"shadow\" 影子 低帮 复古篮球鞋",
  "brandName": "Jordan",
  "productId": "1547881",
  "spuId": "1547881",
  "skuId": "603407918",
  "categoryId": "1001176",
  "priceCny": 495.0,
  "minSalePriceCny": 495.0,
  "maxSalePriceCny": 0,
  "activityPriceCny": 0,
  "soldCountText": "6.3万+人付款",
  "isSold": false,
  "logoUrl": "https://cdn.poizon.com/pro-img/origin-img/...jpg",
  "_sourceKeyword": "Jordan",
  "status": "success"
}
```

***

### 💼 Use Cases & Examples

#### 1. Sneaker Price Monitoring

**Resellers and shops tracking China-side prices for a roster of models.**

**Input:** A list of sneaker keywords
**Output:** Min / max / activity prices per product, per run
**Use:** Schedule daily runs to catch price drops and promo campaigns before competitors do.

#### 2. Resale Arbitrage Research

**Arbitrage analysts comparing China prices against Western marketplaces.**

**Input:** Keywords for high-demand models
**Output:** Resale flag, prices and sold counts
**Use:** Find spreads between Dewu (Poizon) and other resale platforms.

#### 3. Brand Catalog Tracking

**Brand-monitoring teams mapping a brand's footprint and pricing.**

**Input:** Brand and model keywords
**Output:** Brand, category, prices and demand per product
**Use:** Build a longitudinal view of pricing and assortment over time.

#### 4. Streetwear Market Research

**Researchers sizing demand in streetwear and luxury categories.**

**Input:** Category and collab keywords
**Output:** Structured product rows with sold-count signals
**Use:** Benchmark pricing and study what sells on China's top authenticated resale marketplace.

#### 5. Dropshipping & Sourcing

**Cross-border sellers discovering and pricing trending products.**

**Input:** Product keywords
**Output:** Prices, brands and sold counts
**Use:** Inform sourcing and assortment decisions with real demand data.

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/dewu-poizon-product-scraper').call({
  operation: 'keywordSearch',
  keyword: 'Air Jordan 1'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/dewu-poizon-product-scraper').call(
    run_input={'operation': 'keywordSearch', 'keyword': 'Air Jordan 1'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~dewu-poizon-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation":"keywordSearch","keyword":"Air Jordan 1"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule or webhook
2. **HTTP Request**: Call the actor API
3. **Process**: Handle the JSON product rows
4. **Action**: Save, notify, or feed a pricing dashboard

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- Up to **5 keywords** per run — full feature access, same quality
- No credit card required
- Perfect for testing and small watchlists

#### PAID Tier (Production Ready)

- **Unlimited** keywords per run
- Faster, no delays
- Pay-per-result: you're only charged for the unique products returned

💰 **Transparent pricing** — duplicates and errors are never charged.

🔗 [View current pricing](https://apify.com/sian.agency/dewu-poizon-product-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many keywords can I search per run?**
A: FREE tier: 5 keywords. PAID tier: unlimited.

**Q: How many products do I get per keyword?**
A: The marketplace returns a relevance-ranked slice of roughly 20+ top products per keyword. Use `maxResults` to cap it.

**Q: Are prices in CNY or fen?**
A: Both — normalized CNY fields (`priceCny`, `minSalePriceCny`…) plus the raw fen values if you need them.

**Q: Can I search in Chinese?**
A: Yes — keywords work in English or Chinese (e.g. `Nike` or `耐克`).

**Q: What output formats are available?**
A: JSON, CSV and Excel — export directly from the Apify dataset.

**Q: Is this legal?**
A: Yes — only publicly available marketplace data is extracted. See the legal section below.

***

### 🐛 Troubleshooting

**No products returned for a keyword**

- Try a more common or broader term (brand or model name)
- Check the keyword spelling; try the English brand name

**A keyword shows a "please retry" message**

- The marketplace occasionally returns a temporary collection signal — the actor retries automatically; re-run if it persists

**FREE tier only processed some of my keywords**

- FREE tier is capped at 5 keywords per run — upgrade for unlimited, or split your watchlist across runs

***

### ⚠️ Trademark Disclaimer

This is an independent tool and is **not affiliated with, endorsed by, or sponsored by** Dewu, Poizon (得物), or any of their parent or subsidiary companies. "Dewu", "Poizon" and all related names, marks, logos and brand names are trademarks of their respective owners and are used here for identification and descriptive purposes only. This actor accesses only publicly available marketplace data and does not use any official Dewu/Poizon API.

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

***

### 🤝 Support

[![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi)

**Join our active support community**

- For issues or questions, open an issue in the actor's Issues tab
- Check the [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `operation` (type: `string`):

🛠️ **OPERATION:** Choose what to scrape. The marketplace exposes keyword product search.

🔍 **Product Search** — find products by keyword and export prices, brand, category, SKU IDs and sold counts.

## `keyword` (type: `string`):

🔍 **SINGLE KEYWORD SEARCH:** Enter one product keyword to search the marketplace.

💡 **Examples:** `Nike`, `Air Jordan 1`, `Yeezy`, `Supreme`, `Rolex`, or Chinese terms like `耐克`.

📦 Each keyword returns a relevance-ranked slice of top products with full pricing.

💡 **TIP:** Use the **Bulk Keywords** field below to sweep a whole watchlist in one run.

## `keywords` (type: `array`):

🚀 **BULK KEYWORD SEARCH:** Search many keywords in one run — perfect for monitoring a brand watchlist.

📊 **TIER-BASED LIMITS:**

- **FREE users:** Up to 5 keywords per run
- **PAID users:** Unlimited keywords

✏️ **BULK EDIT:** Click "Bulk edit" to paste keywords (one per line).

💡 **IMPORTANT:** Provide either a single keyword OR bulk keywords (at least one is required).

## `keywordsFileUrl` (type: `string`):

📄 **KEYWORDS FROM A FILE:** Provide a public URL to a plain-text file with one keyword per line. Useful for large, version-controlled watchlists.

📊 Tier limits apply the same as Bulk Keywords (FREE: 5, PAID: unlimited).

## `maxResults` (type: `integer`):

🔢 **RESULT CAP:** Maximum unique products to return per keyword (5–100). The marketplace returns roughly 20 top-ranked products per keyword; lower this to trim dataset size.

💡 Default 25 captures the full relevance slice.

## Actor input object example

```json
{
  "operation": "keywordSearch",
  "keyword": "Air Jordan 1",
  "keywords": [
    "Air Jordan 1",
    "Yeezy Boost 350",
    "Supreme Box Logo"
  ],
  "keywordsFileUrl": "https://example.com/keywords.txt",
  "maxResults": 25
}
```

# Actor output Schema

## `results` (type: `string`):

Matched products — one flat row per product with brand, category, min/max/activity/origin prices (CNY + raw fen), SKU/SPU IDs, image URL, sold count and resale flag.

## `report` (type: `string`):

HTML report with run status, success/error row counts, unique products, success rate, duration, and the keywords used — written even on fatal crash.

# 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 = {
    "keyword": "Air Jordan 1"
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/dewu-poizon-product-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 = { "keyword": "Air Jordan 1" }

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/dewu-poizon-product-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 '{
  "keyword": "Air Jordan 1"
}' |
apify call sian.agency/dewu-poizon-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sian.agency/dewu-poizon-product-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Dewu (Poizon) Product Scraper — Sneaker Price & Search API",
        "description": "Search Dewu (Poizon), China's top sneaker, streetwear and luxury resale marketplace, by keyword and export clean product data: title, brand, category, min/max/activity prices, SKU IDs and sold counts. Bulk keyword input, JSON/CSV/Excel output for price monitoring and market research.",
        "version": "1.0",
        "x-build-id": "H6vuy6dM0YboYRVOW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~dewu-poizon-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-dewu-poizon-product-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/sian.agency~dewu-poizon-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-dewu-poizon-product-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/sian.agency~dewu-poizon-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-dewu-poizon-product-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": {
                    "operation": {
                        "title": "🛠️ Operation",
                        "enum": [
                            "keywordSearch"
                        ],
                        "type": "string",
                        "description": "🛠️ **OPERATION:** Choose what to scrape. The marketplace exposes keyword product search.\n\n🔍 **Product Search** — find products by keyword and export prices, brand, category, SKU IDs and sold counts.",
                        "default": "keywordSearch"
                    },
                    "keyword": {
                        "title": "🔍 Search Keyword (Single)",
                        "type": "string",
                        "description": "🔍 **SINGLE KEYWORD SEARCH:** Enter one product keyword to search the marketplace.\n\n💡 **Examples:** `Nike`, `Air Jordan 1`, `Yeezy`, `Supreme`, `Rolex`, or Chinese terms like `耐克`.\n\n📦 Each keyword returns a relevance-ranked slice of top products with full pricing.\n\n💡 **TIP:** Use the **Bulk Keywords** field below to sweep a whole watchlist in one run."
                    },
                    "keywords": {
                        "title": "🚀 Bulk Keywords (Multiple)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "🚀 **BULK KEYWORD SEARCH:** Search many keywords in one run — perfect for monitoring a brand watchlist.\n\n📊 **TIER-BASED LIMITS:**\n- **FREE users:** Up to 5 keywords per run\n- **PAID users:** Unlimited keywords\n\n✏️ **BULK EDIT:** Click \"Bulk edit\" to paste keywords (one per line).\n\n💡 **IMPORTANT:** Provide either a single keyword OR bulk keywords (at least one is required).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "keywordsFileUrl": {
                        "title": "📄 Keywords from File URL (Optional)",
                        "type": "string",
                        "description": "📄 **KEYWORDS FROM A FILE:** Provide a public URL to a plain-text file with one keyword per line. Useful for large, version-controlled watchlists.\n\n📊 Tier limits apply the same as Bulk Keywords (FREE: 5, PAID: unlimited)."
                    },
                    "maxResults": {
                        "title": "🔢 Max Results per Keyword",
                        "minimum": 5,
                        "maximum": 100,
                        "type": "integer",
                        "description": "🔢 **RESULT CAP:** Maximum unique products to return per keyword (5–100). The marketplace returns roughly 20 top-ranked products per keyword; lower this to trim dataset size.\n\n💡 Default 25 captures the full relevance slice.",
                        "default": 25
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```