# 1688 Product Finder (`burbn/1688-product-search`) Actor

Find profitable products on 1688 for dropshipping & Amazon FBA. Compare supplier prices in USD, analyze wholesale quantity breaks, and track trending products effortlessly.

- **URL**: https://apify.com/burbn/1688-product-search.md
- **Developed by:** [Kevin](https://apify.com/burbn) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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/docs.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## 1688 Product Search – China Wholesale Product Data Extractor

**Search 1688.com (Alibaba China) products by keyword, category, or vendor and extract detailed product data including pricing in CNY & USD, vendor info, quantity ranges, images, and physical parameters. Supports pagination, sorting, price filtering, and multi-language output. Built with Apify best practices for reliability and speed.**

---

### Table of Contents

- [Features](#features)
- [Use Cases](#use-cases)
- [Quick Start](#quick-start)
- [Input Parameters](#input-parameters)
- [Output Format](#output-format)
- [Sorting Options](#sorting-options)
- [Language Support](#language-support)
- [Performance & Limits](#performance--limits)
- [FAQ](#faq)
- [Troubleshooting](#troubleshooting)
- [Tags](#tags)

---

### Features

- **Keyword Search** – Search 1688.com's full product catalog using any keyword or phrase in any supported language.
- **Multi-Language Support** – Get product titles and descriptions in 35+ languages including English, Chinese, Spanish, French, Japanese, Korean, Arabic, and more.
- **Pagination Support** – Scrape up to 250 pages of search results per run (~10,000 products) for large-scale data collection.
- **Sorting Options** – Sort results by Recently Updated, Price Low-to-High, or Price High-to-Low.
- **Price Range Filtering** – Set minimum and/or maximum price in CNY to narrow down products within your budget.
- **Category Filtering** – Filter results by a specific 1688 category ID for targeted product discovery.
- **Vendor Filtering** – Search products from a specific vendor/store on 1688.
- **Dual Currency Pricing** – Get prices in both Chinese Yuan (CNY) and US Dollar (USD) automatically.
- **Quantity Tier Pricing** – Extract wholesale tier pricing (e.g., 1-9 units, 10-49 units, 50+ units).
- **Rich Product Data** – Extract images (multiple sizes), vendor info, brand details, physical parameters, stock quantity, and more.

---

### Use Cases

| Use Case | Description | Key Benefits |
|----------|-------------|--------------|
| Wholesale Sourcing | Find Chinese wholesale products at factory prices on 1688. | Access the largest Chinese B2B marketplace with real-time pricing. |
| Price Monitoring | Track 1688 product prices over time for dynamic pricing strategies. | Detect price changes in both CNY and USD simultaneously. |
| Competitor Analysis | Monitor vendor products, pricing, and quantity tiers across categories. | Benchmark against Chinese suppliers and discover new products. |
| Product Research | Search product categories to analyze trends, brands, and wholesale pricing. | Discover trending wholesale products with tier pricing data. |
| Dropshipping & Arbitrage | Find profitable products by comparing 1688 prices with other marketplaces. | Automate product discovery with price and category filters. |
| Supply Chain Intelligence | Enrich your database with 1688 vendor data, stock levels, and shipping parameters. | Automate supplier evaluation with vendor scores and stock data. |

---

### Quick Start

#### 1. Basic – Simple Keyword Search
```json
{
  "query": "LED light",
  "maxPages": 1
}
````

#### 2. Advanced – Sorted by Price with Category Filter

```json
{
  "query": "phone case",
  "sortBy": "Price:Asc",
  "categoryId": "10206",
  "maxPages": 3
}
```

#### 3. Multi-Language – Japanese Output

```json
{
  "query": "wireless earbuds",
  "language": "ja",
  "maxPages": 2
}
```

#### 4. Full Filters – Price Range + Vendor + Sorting

```json
{
  "query": "Polymer Lithium Battery",
  "sortBy": "UpdatedTime:Desc",
  "minPrice": 10,
  "maxPrice": 500,
  "language": "en",
  "maxPages": 5
}
```

***

### Input Parameters

| Parameter | Type | Required | Description | Default | Example |
|-----------|------|----------|-------------|---------|---------|
| `query` | String | Yes | Search keyword or phrase to find products on 1688 | - | `"LED light"`, `"phone case"`, `"Polymer Lithium Battery"` |
| `language` | String | No | Language for product titles and descriptions (see [Language Support](#language-support)) | `"en"` | `"zh-chs"`, `"ja"`, `"ko"` |
| `sortBy` | String | No | Sort order for results (see [Sorting Options](#sorting-options)) | `"UpdatedTime:Desc"` | `"Price:Asc"`, `"Price:Desc"` |
| `categoryId` | String | No | 1688 category ID to filter results. Leave empty for all categories | - | `"10206"`, `"1032307"` |
| `vendorName` | String | No | Filter by specific vendor/store name on 1688 | - | `"b2b-221850414746747d22"` |
| `minPrice` | Number | No | Minimum product price in CNY (Chinese Yuan) | - | `10`, `50`, `100` |
| `maxPrice` | Number | No | Maximum product price in CNY (Chinese Yuan) | - | `500`, `1000`, `5000` |
| `maxPages` | Integer | No | Number of result pages to scrape (1–250). Each page returns ~40 products | `1` | `3`, `10`, `50` |

***

### Output Format

#### Product Result Data Structure

```json
{
  "source": "1688_product_search",
  "search_query": "Polymer Lithium Battery",
  "position": 1,

  "id": "abb-969369401690",
  "title": "Electric bike, lithium battery, smart electric car",
  "original_title": "出口长续航电动摩托车自行车小九牛号锂电池电瓶车智能车电动车",
  "is_title_translated": true,

  "category_id": "abb-1221",
  "external_category_id": "1221",

  "external_item_url": "https://detail.1688.com/offer/969369401690.html",
  "taobao_item_url": "https://detail.1688.com/offer/969369401690.html",

  "vendor_id": "abb-b2b-221850414746747d22",
  "vendor_name": "b2b-221850414746747d22",
  "vendor_display_name": "b2b-221850414746747d22",
  "vendor_score": 12,

  "brand_id": "abb-琪尚",
  "brand_name": "琪尚",

  "provider_type": "Alibaba1688",

  "price_cny": 1387,
  "margin_price_cny": 1387,
  "original_currency": "CNY",

  "price_usd": 191,
  "converted_price": "191.00$",
  "converted_price_without_sign": "191.00",
  "currency_sign": "$",
  "currency_name": "USD",

  "is_deliverable": false,
  "delivery_price_cny": 0,
  "delivery_price_usd": 0,

  "quantity_ranges": [
    {
      "min_quantity": 1,
      "price_cny": 6000,
      "price_usd": 824,
      "converted_price": "824.00$"
    },
    {
      "min_quantity": 5,
      "price_cny": 5800,
      "price_usd": 797,
      "converted_price": "797.00$"
    },
    {
      "min_quantity": 10,
      "price_cny": 5500,
      "price_usd": 756,
      "converted_price": "756.00$"
    }
  ],

  "stuff_status": "New",
  "volume": 0,
  "master_quantity": 599,
  "is_sell_allowed": true,
  "is_filtered": false,

  "main_image": "https://cbu01.alicdn.com/img/ibank/...",
  "images": [
    {
      "url": "https://cbu01.alicdn.com/img/ibank/...",
      "small": "https://cbu01.alicdn.com/img/ibank/...100x100.jpg",
      "medium": "https://cbu01.alicdn.com/img/ibank/...310x310.jpg",
      "large": "https://cbu01.alicdn.com/img/ibank/...600x600.jpg",
      "is_main": true
    }
  ],

  "weight_kg": 65,
  "length_cm": 165,
  "width_cm": 45,
  "height_cm": 85,

  "features": [],
  "featured_values": {
    "encrypted_vendor_id": "BBB9eSevm_FL6Ckft7N4_QCZA"
  },

  "created_time": "2025-12-10T16:26:43.139Z",
  "updated_time": "2026-07-25T02:04:00.652Z",
  "last_updated_time": "2026-07-25T02:04:00.652Z",

  "scraped_at": "2026-07-25T12:30:00.000Z"
}
```

#### Output Fields Explained

| Field | Type | Description |
|-------|------|-------------|
| `source` | String | Source indicator, always `1688_product_search` |
| `search_query` | String | The keyword used for the search |
| `position` | Integer | Position of the product in the scraper batch (1-based) |
| `id` | String | 1688 internal product ID |
| `title` | String | Product title (translated to selected language) |
| `original_title` | String | Original Chinese product title |
| `is_title_translated` | Boolean | Whether the title was manually translated |
| `category_id` | String | Internal category ID |
| `external_category_id` | String | 1688 external category ID |
| `external_item_url` | String | Direct link to the product on 1688.com |
| `taobao_item_url` | String | Alternative product URL |
| `vendor_id` | String | Unique vendor/store ID |
| `vendor_name` | String | Vendor username |
| `vendor_display_name` | String | Vendor display name |
| `vendor_score` | Number | Vendor reliability score |
| `brand_id` | String | Brand identifier |
| `brand_name` | String | Brand name |
| `provider_type` | String | Data provider type (always `Alibaba1688`) |
| `price_cny` | Number | Product price in Chinese Yuan (CNY) |
| `margin_price_cny` | Number | Margin/wholesale price in CNY |
| `original_currency` | String | Original currency code (always `CNY`) |
| `price_usd` | Number | Converted price in US Dollars |
| `converted_price` | String | Formatted converted price with currency sign |
| `converted_price_without_sign` | String | Converted price without currency sign |
| `currency_sign` | String | Currency sign (e.g., `$`) |
| `currency_name` | String | Currency name (e.g., `USD`) |
| `is_deliverable` | Boolean | Whether delivery pricing is available |
| `delivery_price_cny` | Number | Delivery cost in CNY |
| `delivery_price_usd` | Number | Delivery cost in USD |
| `quantity_ranges` | Array | Wholesale tier pricing with min quantity and prices |
| `stuff_status` | String | Product condition (e.g., `New`) |
| `volume` | Number | Sales volume |
| `master_quantity` | Number | Available stock quantity |
| `is_sell_allowed` | Boolean | Whether the product is available for sale |
| `is_filtered` | Boolean | Whether the product was filtered by the API |
| `main_image` | String | URL of the main product image |
| `images` | Array | List of product images with small, medium, and large URLs |
| `weight_kg` | Number | Product weight in kilograms |
| `length_cm` | Number | Product length in centimeters |
| `width_cm` | Number | Product width in centimeters |
| `height_cm` | Number | Product height in centimeters |
| `features` | Array | Product feature tags (e.g., `Expired`) |
| `featured_values` | Object | Additional product attributes as key-value pairs |
| `created_time` | String | ISO timestamp when the product was first listed |
| `updated_time` | String | ISO timestamp when the product was last updated |
| `last_updated_time` | String | ISO timestamp of the latest update |
| `scraped_at` | String | ISO timestamp of when the data was extracted |

***

### Sorting Options

| Value | Description |
|-------|-------------|
| `UpdatedTime:Desc` | Most recently updated products first (default) |
| `UpdatedTime:Asc` | Oldest updated products first |
| `Price:Asc` | Cheapest products first |
| `Price:Desc` | Most expensive products first |

***

### Language Support

The API supports 35+ languages for product titles and descriptions:

| Code | Language | Code | Language |
|------|----------|------|----------|
| `en` | English | `ja` | Japanese |
| `zh-chs` | Chinese (Simplified) | `ko` | Korean |
| `ru` | Russian | `ar` | Arabic |
| `es` | Spanish | `vi` | Vietnamese |
| `de` | German | `tr` | Turkish |
| `pt` | Portuguese | `th` | Thai |
| `fr` | French | `pl` | Polish |

And many more: `ro`, `uk`, `fi`, `bg`, `he`, `hy`, `ka`, `az`, `ky`, `kk`, `ms`, `uz`, `no`, `km`, `ku`, `el`, `am`, `my`, `cz`, `khk`, `sah`.

***

### Performance & Limits

- **Pagination Limit** – Up to 250 pages per query (max ~10,000 products at ~40 items/page).
- **Items Per Page** – Each page returns approximately 40 products (determined by the API's `CurrentFrameSize`).
- **Batching** – Data is saved in batches of 10 items to prevent loss during unexpected errors.
- **Rate Limiting** – Built-in 1.5-second delay between page requests for optimal throughput.
- **Concurrency** – Automatic key rotation and retry logic for smooth, uninterrupted performance.

***

### FAQ

- **Q: Where does the data come from?**
  - All data is fetched dynamically from 1688.com's product database.
- **Q: Can I get prices in USD?**
  - Yes! The API automatically converts CNY prices to USD. Both `price_cny` and `price_usd` are included in every product result.
- **Q: What are quantity ranges?**
  - 1688 is a wholesale marketplace, so many products have tier pricing. The `quantity_ranges` field shows price breaks based on order quantity (e.g., 1-9 units at ¥100, 10+ units at ¥80).
- **Q: How do I filter by category?**
  - Use the `categoryId` input parameter with a valid 1688 category ID. You can discover category IDs from the product results.
- **Q: Can I search in Chinese?**
  - Yes! You can enter Chinese keywords in the `query` field. Set `language` to `zh-chs` for Chinese results, or keep it as `en` for translated titles.
- **Q: What data formats can I export?**
  - Apify supports exporting results as JSON, CSV, Excel (XLSX), XML, HTML, and RSS.

***

### Troubleshooting

| Issue | Cause | Solution |
|-------|-------|----------|
| "No search query provided" | Empty or missing `query` | Enter a valid search term in the input |
| No products found | Keyword is too specific or has no matching products | Broaden the search query or remove filters |
| API returned error | Unexpected API response or invalid parameters | Check the error message and retry. Verify your parameters |
| Slow execution | Many pages requested | Reduce `maxPages` to run faster |
| Rate limit exceeded | Too many concurrent requests | Wait a few minutes and try again |

***

### Why Choose This Actor?

- Keyword-based 1688.com product search
- Real-time pricing in both CNY and USD
- Wholesale tier pricing (quantity ranges)
- Vendor info with reliability scores
- Multi-language support (35+ languages)
- Category and vendor filtering
- Physical product parameters (weight, dimensions)
- Multiple image sizes (small, medium, large)
- Downloadable as CSV, Excel, JSON, XML, or HTML

***

### Tags

`1688 scraper`, `1688 product data`, `alibaba china scraper`, `china wholesale scraper`, `1688 price tracker`, `1688 api`, `wholesale product search`, `chinese marketplace scraper`, `b2b product data`, `supplier data extraction`, `1688 product search`, `apify actor`

***

### Get Started Now

1. Enter the **Search Query** (e.g., `LED light`)
2. Choose the **Language** (e.g., English)
3. Choose the **Sort Order** (e.g., Recently Updated)
4. Optionally set **Category ID**, **Vendor Name**, or **Price Range** filters
5. Set the **Maximum Pages** to scrape
6. Click **Start** to run the scraper
7. Export your data in JSON, CSV, or Excel format
8. Click ["Try for free"](https://apify.com?fpr=free-credits) to test the actor

***

*Built using Apify Platform | Optimized for Performance & Reliability*

# Actor input Schema

## `query` (type: `string`):

💬 Enter your search keyword or phrase (e.g., 'Polymer Lithium Battery', 'LED Light', 'Phone Case'). This is the main search term to find products on 1688.com.

## `language` (type: `string`):

🗣️ Choose the language for product titles and descriptions in the response.

## `sortBy` (type: `string`):

🔄 Choose how to sort the search results.

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

🏷️ Filter by a specific 1688 category ID. Leave empty to search across all categories.

## `vendorName` (type: `string`):

🔍 Only return products from a specific vendor/store. Leave empty for all vendors.

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

💰 Only return products with a price greater than or equal to this value (in Chinese Yuan / CNY).

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

💰 Only return products with a price less than or equal to this value (in Chinese Yuan / CNY).

## `maxPages` (type: `integer`):

📊 Number of result pages to scrape (1–250). Each page returns ~40 products. More pages = more results but longer runtime.

## Actor input object example

```json
{
  "query": "Polymer Lithium Battery",
  "language": "en",
  "sortBy": "UpdatedTime:Desc",
  "maxPages": 1
}
```

# Actor output Schema

## `products_overview` (type: `string`):

Open the dataset view with an overview of all products including title, brand, price, vendor, and stock quantity.

# 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 = {
    "query": "Polymer Lithium Battery",
    "language": "en",
    "sortBy": "UpdatedTime:Desc",
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("burbn/1688-product-search").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 = {
    "query": "Polymer Lithium Battery",
    "language": "en",
    "sortBy": "UpdatedTime:Desc",
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("burbn/1688-product-search").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 '{
  "query": "Polymer Lithium Battery",
  "language": "en",
  "sortBy": "UpdatedTime:Desc",
  "maxPages": 1
}' |
apify call burbn/1688-product-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=burbn/1688-product-search",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "1688 Product Finder",
        "description": "Find profitable products on 1688 for dropshipping & Amazon FBA. Compare supplier prices in USD, analyze wholesale quantity breaks, and track trending products effortlessly.",
        "version": "1.0",
        "x-build-id": "66J04PPyxbxqnBr4h"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/burbn~1688-product-search/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-burbn-1688-product-search",
                "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/burbn~1688-product-search/runs": {
            "post": {
                "operationId": "runs-sync-burbn-1688-product-search",
                "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/burbn~1688-product-search/run-sync": {
            "post": {
                "operationId": "run-sync-burbn-1688-product-search",
                "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": [
                    "query"
                ],
                "properties": {
                    "query": {
                        "title": "🔎 Search Query",
                        "minLength": 1,
                        "maxLength": 500,
                        "type": "string",
                        "description": "💬 Enter your search keyword or phrase (e.g., 'Polymer Lithium Battery', 'LED Light', 'Phone Case'). This is the main search term to find products on 1688.com.",
                        "default": "Polymer Lithium Battery"
                    },
                    "language": {
                        "title": "🌐 Language",
                        "enum": [
                            "en",
                            "zh-chs",
                            "ru",
                            "es",
                            "de",
                            "pt",
                            "fr",
                            "ja",
                            "ko",
                            "ar",
                            "vi",
                            "tr",
                            "th",
                            "pl",
                            "ro",
                            "uk",
                            "fi",
                            "bg",
                            "he",
                            "hy",
                            "ka",
                            "az",
                            "ky",
                            "kk",
                            "ms",
                            "uz",
                            "no",
                            "km",
                            "ku",
                            "el",
                            "am",
                            "my",
                            "cz",
                            "khk",
                            "sah"
                        ],
                        "type": "string",
                        "description": "🗣️ Choose the language for product titles and descriptions in the response.",
                        "default": "en"
                    },
                    "sortBy": {
                        "title": "📊 Sort Order",
                        "enum": [
                            "UpdatedTime:Desc",
                            "UpdatedTime:Asc",
                            "Price:Asc",
                            "Price:Desc"
                        ],
                        "type": "string",
                        "description": "🔄 Choose how to sort the search results.",
                        "default": "UpdatedTime:Desc"
                    },
                    "categoryId": {
                        "title": "📂 Category ID",
                        "type": "string",
                        "description": "🏷️ Filter by a specific 1688 category ID. Leave empty to search across all categories."
                    },
                    "vendorName": {
                        "title": "🏪 Vendor Name",
                        "type": "string",
                        "description": "🔍 Only return products from a specific vendor/store. Leave empty for all vendors."
                    },
                    "minPrice": {
                        "title": "💵 Minimum Price (CNY ¥)",
                        "minimum": 0,
                        "type": "number",
                        "description": "💰 Only return products with a price greater than or equal to this value (in Chinese Yuan / CNY)."
                    },
                    "maxPrice": {
                        "title": "💎 Maximum Price (CNY ¥)",
                        "minimum": 0,
                        "type": "number",
                        "description": "💰 Only return products with a price less than or equal to this value (in Chinese Yuan / CNY)."
                    },
                    "maxPages": {
                        "title": "📄 Maximum Pages",
                        "minimum": 1,
                        "maximum": 250,
                        "type": "integer",
                        "description": "📊 Number of result pages to scrape (1–250). Each page returns ~40 products. More pages = more results but longer runtime.",
                        "default": 1
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
