# 1688 Search Results Scraper: Fast Product Cards (`theshark/1688-search-results-scraper`) Actor

Fast, low-cost 1688.com search scraper: products straight from the search results for your keywords, search links or category, up to 5,000 per query. Price tiers, MOQ, sales, supplier, region, trade scores and image. Filters on 1688's side. No login.

- **URL**: https://apify.com/theshark/1688-search-results-scraper.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 product from 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.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 1688 Search Results Scraper: Fast Product Lists from 1688.com

Scrape search results from [1688.com](https://www.1688.com) (Alibaba 1688), China's largest wholesale marketplace, fast and at a low price. Give keywords, 1688 search links or a category, and get one row per product card: title, price, quantity price tiers, minimum order quantity (MOQ), sales, supplier, region, years on 1688, trade scores and image. Up to 5,000 products per query, with 1688's own filters for dropshipping, free shipping, verified factories and more.

No 1688 account, login, cookies or proxies of your own are needed. You pay only for products that were collected successfully.

### What can you do with 1688 Search Results Scraper?

- **Research a niche:** collect thousands of product cards for a keyword and compare prices, sales and suppliers.
- **Build product lists:** export titles, prices, images and links to a spreadsheet or your catalog.
- **Find suppliers by region:** filter by province and city, for example factories in 浙江 or 广东.
- **Track the market:** run the same search on a schedule and compare prices and sales over time.
- **Feed other tools:** pass the offer IDs to [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper) for full product pages.

### What data do you get?

| Data | Fields |
|---|---|
| Product | offer ID, link, title, image |
| Price | price, quantity price tiers and MOQ (when 1688 shows them in the search card) |
| Sales | sold count and the sales text as 1688 shows it |
| Supplier | company name, member ID, province, city, years on 1688, trade scores (overall, goods, logistics, disputes, returns, consultation), inspection badges |
| Search | promoted flag, repeat purchase rate, the keyword, link or category that found the product |

### How to scrape 1688 search results

1. Enter one or more **keywords** (Chinese works best, English works too), 1688 **search links** or a **category ID**.
2. Set **Max results** and, if you like, filters: price, MOQ, region, merchant type, dropshipping, free shipping and others.
3. Click **Start**. Products appear in the dataset while the run goes on.
4. Download the results as JSON, CSV, Excel or HTML, or get them through the API.

If you start the actor with an empty input, it runs a small example search, so you can see what the data looks like.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `keywords` | list of strings | empty | Search keywords, Chinese or English, for example `["保温杯", "thermos cup"]`. Each keyword is searched separately. |
| `searchUrls` | list of strings | empty | Links to 1688 search results. The keyword and filters of the link are used and win over the filters of the form. |
| `categoryId` | string | none | 1688 category ID of level 1 or 2 (for example `1813` for toys). Alone it is a search by itself; next to keywords or links it is a filter. |
| `maxResults` | integer, 1 to 5000 | `100` | Maximum number of products per keyword, link or category. |
| `sortBy` | `relevance`, `bestSelling`, `priceAsc`, `priceDesc` | `relevance` | Order of search results. |
| `priceMin`, `priceMax` | number (CNY) | none | Only products priced at or above, or at or below, this value. |
| `minOrderQuantityFrom`, `minOrderQuantity` | integer | none | Only products whose MOQ is at least, or at most, this value. |
| `merchantType` | `any`, `verifiedMerchant` | `any` | `verifiedMerchant`: only verified merchants (实力商家), with 1688's own search filter. |
| `province`, `city` | string | none | Supplier province and city in Chinese characters, for example `广东`, `深圳`. Several provinces can be separated by commas. |
| `dropshipping`, `freeShipping`, `dropshipFreeShipping`, `sevenDayReturn`, `fastInvoice`, `officialLogistics`, `verifiedFactory`, `bigBrandOem` | boolean | `false` | Yes/no filters that 1688 applies on its side. Some pairs cannot be combined on 1688: the first one is used and a warning says so. |
| `excludeKeywords` | list of strings | empty | Skip products whose title contains any of these words. |

#### Examples

Best sellers under 30 CNY:

```json
{ "keywords": ["保温杯", "thermos cup"], "maxResults": 500, "sortBy": "bestSelling", "priceMax": 30 }
```

Dropshipping suppliers in Zhejiang:

```json
{ "keywords": ["手机壳"], "maxResults": 1000, "dropshipping": true, "province": "浙江" }
```

A 1688 search link (its keyword and filters are used):

```json
{
  "searchUrls": ["https://s.1688.com/selloffer/offer_search.htm?keywords=%CA%D6%BB%FA%BF%C7&priceStart=5"],
  "maxResults": 200
}
```

A whole category, best sellers first:

```json
{ "categoryId": "1813", "maxResults": 200, "sortBy": "bestSelling" }
```

### Output

One dataset row per product card, shown in the **Search cards** view. Rows can be downloaded as JSON, CSV, Excel and more. Titles and supplier names are in the original Chinese, prices are in CNY. Example row:

```json
{
  "offerId": "991730585225",
  "detailUrl": "https://detail.1688.com/offer/991730585225.html",
  "status": "OK",
  "dataLevel": "card",
  "title": "316不锈钢保温杯男女士户外车载水杯便携加厚双层真空保温杯定制",
  "price": 15.5,
  "quantityPrices": [{ "minQuantity": 1, "maxQuantity": null, "price": 15.5 }],
  "minOrderQuantity": 1,
  "soldCount": 50000,
  "soldText": "全网5.0万+件",
  "companyName": "永康市希杰工贸有限公司",
  "province": "浙江",
  "city": "金华市",
  "tpYear": 2,
  "tradeScores": { "composite": 5, "goods": 3.67, "logistics": 4, "dispute": 4, "return": 4, "consultation": 4.5 },
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01qthD5I1g0EecumU2L_!!2218992714079-0-cib.jpg",
  "sourceKeyword": "保温杯",
  "source": { "type": "keyword", "value": "保温杯", "keyword": "保温杯" },
  "scrapedAt": "2026-11-13T12:00:00+00:00"
}
```

### How much does it cost to scrape 1688 search results?

Pay per event: one flat price per product card (`product-card`, status `OK`), and nothing for cards skipped by your filters. The current price is on the **Pricing** tab. Set a maximum charge per run in Apify and the actor stops cleanly when it is reached.

#### Row statuses

| Status | Meaning | Charged? |
|---|---|---|
| `OK` | The product card was collected. | Yes |
| `NOT_FOUND` | A search found nothing, or nothing that passes your filters. | No |
| `ERROR` | The row could not be collected, for example an invalid link or a card without a price. `statusMessage` says why. | No |

### Good to know

- **Up to 5,000 products per query.** One 1688 search gives up to 300 products. Deeper results come from extra searches split by price range and sort order, so they take longer and are less relevant. For the most relevant products, use more specific keywords or filters.
- **Search cards, not product pages.** Rows have the fields of the search card. For variants, stock, attributes, description, reviews and the supplier profile use [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper).
- **Data is in Chinese.** Titles and supplier names come as 1688 shows them. Prices are in CNY.
- **No contacts.** No phone numbers, emails, WeChat or QQ.
- **Run settings.** Give the run a timeout of at least 5 minutes. The minimum memory is 1024 MB.

### Integrations and API

Start runs and download results with the [Apify API](https://docs.apify.com/api/v2) or the Apify clients for Python and JavaScript, run on a schedule, and send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.

### FAQ

**Which keywords work best?**
Chinese keywords give the most relevant results; English keywords work too.

**How many products can I get for one keyword?**
Up to 5,000 per query.

**Do I need a 1688 account or proxies?**
No. The actor uses its own proxies in China and does not log in.

**Is it legal to scrape 1688?**
The actor collects only publicly visible product information and no personal data. You are responsible for how you use the data and for following the laws and terms that apply to you.

### More 1688 scrapers

- [1688.com Wholesale Scraper](https://apify.com/TheShark/china-1688-scraper): every mode in one actor, plus suppliers and price monitoring.
- [1688 Image Search Scraper](https://apify.com/TheShark/1688-image-search-scraper): find products and suppliers by photo.
- [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper): full product pages by link or offer ID.
- [1688 Supplier Scraper](https://apify.com/TheShark/1688-supplier-scraper): supplier profiles and their products.
- [1688 Price Monitor](https://apify.com/TheShark/1688-price-monitor): track prices, stock and sales of your products.

# Actor input Schema

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

Search keywords, Chinese or English, for example 手机壳 or phone case. Each keyword is searched separately.

## `searchUrls` (type: `array`):

Links to 1688 search results (s.1688.com/selloffer/offer_search.htm?..., m.1688.com/offer_search/...). The keyword and the filters from the link are used; they win over the filters below. Each link is searched separately.

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

1688 category ID of level 1 or 2 (for example 1813 for toys, 181309 for a sub-category). With keywords or links it works as a filter; alone it is searched by itself. Leaf categories need a keyword.

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

Maximum number of products per keyword, link or category. One 1688 search gives up to 300 products. Above that, extra searches are made (split by price range and sort order), so the run takes longer and the extra results are less relevant.

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

How search results are ordered.

## `priceMin` (type: `number`):

Only products priced at or above this value, in yuan. Leave empty for no filter.

## `priceMax` (type: `number`):

Only products priced at or below this value, in yuan. Leave empty for no filter.

## `minOrderQuantityFrom` (type: `integer`):

Only products whose minimum order quantity (MOQ) is at least this value. Leave empty for no filter.

## `minOrderQuantity` (type: `integer`):

Only products whose minimum order quantity (MOQ) is at most this value. Leave empty for no filter.

## `merchantType` (type: `string`):

Limit results to verified merchants (实力商家), with 1688's own search filter.

## `province` (type: `string`):

Filter by supplier province, in Chinese characters (for example 广东). Several provinces can be separated by commas (for example 江苏,浙江). Optional.

## `city` (type: `string`):

Filter by supplier city, in Chinese characters (for example 深圳). Optional.

## `dropshipping` (type: `boolean`):

Only suppliers that ship single items directly to your customer.

## `freeShipping` (type: `boolean`):

Only products with free shipping. Cannot be combined with 'Dropshipping with free shipping'; the first one is used.

## `dropshipFreeShipping` (type: `boolean`):

Only products that ship single items with free shipping.

## `sevenDayReturn` (type: `boolean`):

Only products with a 7-day no-reason return. Cannot be combined with 'Fast invoice'; the first one is used.

## `fastInvoice` (type: `boolean`):

Only suppliers that issue invoices quickly.

## `officialLogistics` (type: `boolean`):

Only products shipped with 1688 official logistics.

## `verifiedFactory` (type: `boolean`):

Only suppliers with a verified factory. Cannot be combined with 'Big brand OEM' or the 'Verified merchant' type; the first one is used.

## `bigBrandOem` (type: `boolean`):

Only suppliers that make products for big brands.

## `excludeKeywords` (type: `array`):

Skip products whose title contains any of these words.

## Actor input object example

```json
{
  "maxResults": 100,
  "sortBy": "relevance",
  "merchantType": "any",
  "dropshipping": false,
  "freeShipping": false,
  "dropshipFreeShipping": false,
  "sevenDayReturn": false,
  "fastInvoice": false,
  "officialLogistics": false,
  "verifiedFactory": false,
  "bigBrandOem": false
}
```

# Actor output Schema

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

One dataset row per product.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/1688-search-results-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("theshark/1688-search-results-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call theshark/1688-search-results-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/1688-search-results-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7OCmsLPeK9fRLeKAt/builds/sIo03O35z28OalaCn/openapi.json
