# 1688.com Products Scraper (`neuro-scraper/1688-com-products-scraper`) Actor

1688.com Products Scraper SD - 1688.com Products Scraper is a logged-out tool that extracts 1688.com wholesale products by keyword, offer ID or URL: price tiers, MOQ, stock, SKUs, sold count, repurchase rate, supplier, location, images and description.

- **URL**: https://apify.com/neuro-scraper/1688-com-products-scraper.md
- **Developed by:** [Neuro Scraper](https://apify.com/neuro-scraper) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.19 / 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/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.com Products Scraper

The 1688.com Products Scraper collects public 1688.com products and returns it as a clean dataset you can download as JSON, CSV or Excel, or read through the Apify API. No login, no cookies and no code: give the 1688.com Products Scraper your input, start it and get structured 1688.com data for research, monitoring, analytics or lead generation. You pay only for the results you receive.

> ⭐ **Featured by Neuro Scraper: [Facebook Reels Scraper](https://apify.com/neuro-scraper/facebook-reels-scraper)** - scrape Facebook Reels from any page, profile or reel link with exact views and plays, every reaction type (Like, Love, Care, Haha, Wow, Sad, Angry), comments, shares, captions, music and video links. No login and no cookies. [Try the Facebook Reels Scraper →](https://apify.com/neuro-scraper/facebook-reels-scraper)

./README.md

### Input

Every option of the 1688.com Products Scraper, as it appears in the input form and the API:

| Field | Type | Default | What it does |
|---|---|---|---|
| `keywords` | array | `["手机壳"]` | What you would type into the 1688 search box, one per line. Chinese keywords work best (English works too, with fewer related searches). Each keyword reads 1688's public sponsored-results page (20 offers) and, if more ar |
| `offerIds` | array | `""` | 1688 offer IDs (the number in detail.1688.com/offer/<ID>.html), one per line. Each one gives one product row with every field. Example: 927875250705 |
| `offerUrls` | array | `""` | 1688 product page URLs such as https://detail.1688.com/offer/927875250705.html (m.1688.com offer links work too). One product row each. |
| `maxProducts` | integer | `20` | How many products to return for each keyword. The first 20 come from the keyword's own results page; more come from 1688's related searches (see below). Example: 20 |
| `maxItems` | integer | `50` | Maximum number of product rows for the whole run (all keywords and offers together). Example: 50 |
| `expandRelatedKeywords` | boolean | `true` | 1688 shows 20 offers per keyword page to logged-out visitors and its next-page request is signed, so more results are taken from the related searches 1688 lists on the page (only those that contain your keyword, e.g. 苹果手 |
| `maxRelatedKeywords` | integer | `10` | Safety limit on related-search pages read per keyword (one request each). Example: 10 |
| `includeDetails` | boolean | `true` | For keyword results: open every product's page to add price tiers, MOQ, stock, unit weight, category, attributes, review count and good rate, seller details, location (province / city), delivery promise and services. One |
| `includeSkuDetails` | boolean | `false` | Add skuProps (option names and values with images) and skus (each variant's spec, stock, sales, promotion flag and package size). Needs product pages (on for offer IDs / URLs, or with full details). |
| `includeDescriptionHtml` | boolean | `false` | Download each product's description (one extra small request) and add descriptionHtml, descriptionImages and descriptionText. Many 1688 descriptions are images only, so descriptionText is often empty. |
| `sortBy` | string | `"relevance"` | Order of the returned products per keyword. 1688's logged-out results page ignores sort parameters (measured), so the Actor collects up to twice the wanted number of offers first and sorts them itself. Example: priceAsc |
| `priceMin` | integer | `0` | Keyword results only: skip offers whose lowest price is below this (checked by the Actor - 1688's logged-out page ignores price parameters). 0 = no minimum. Example: 5 |
| `priceMax` | integer | `0` | Keyword results only: skip offers whose lowest price is above this (checked by the Actor). 0 = no maximum. Example: 50 |
| `minOrderQuantity` | integer | `0` | Keyword results only: skip offers whose minimum order quantity is higher than this (read from the product page, so product pages are opened). 0 = any MOQ. Example: 10 |
| `merchantType` | string | `"any"` | Keyword results only: keep offers from 1688 Verified / Powerful merchants (实力商家) or Super Factories (超级工厂), as shown by 1688's own badges on the offer. |
| `province` | string | `""` | Keyword results only: keep offers shipped from this province, in Chinese as on 1688 (广东, 浙江, 福建 ...). Read from the product page. Empty = any. Example: 广东 |
| `city` | string | `""` | Keyword results only: keep offers shipped from this city, in Chinese (义乌, 深圳, 广州 ...). Read from the product page. Empty = any. Example: 深圳 |
| `proxyConfiguration` | object | `{"useApifyProxy": true, "apifyProxyGroup` | Residential proxy in China is the default (1688 is a Chinese domestic site; China and Hong Kong residential IPs were measured to work). A slider page is never answered - the Actor switches to a new IP instead. |

### Output fields

Each 1688.com Products Scraper row is one JSON object with these fields (CSV and Excel exports use the same columns):

- `imageUrl`
- `offerId`
- `title`
- `price`
- `priceMin`
- `priceMax`
- `currency`
- `priceText`
- `priceTiers`
- `minOrderQuantity`
- `unit`
- `stock`
- `soldCount`
- `soldCountText`
- `repurchaseRate`
- `shopRepurchaseRate`
- `goodRate`
- `goodsGrade`
- `reviewCount`
- `sellerServiceScore`
- `images`
- `videoUrl`
- `videoCover`
- `categoryId`
- `categoryName`
- `topCategoryId`
- `brandName`
- `attributes`
- `serviceTags`
- `merchantTags`
- `promotions`
- `isVerifiedMerchant`
- `isSuperFactory`
- `isFactory`
- `supportsDropship`
- `mixSupported`
- `companyName`
- `sellerLoginId`
- `sellerMemberId`
- `sellerUserId`
- `sellerType`
- `yearsOnPlatform`
- `shopUrl`
- `location`
- `province`
- `city`
- `deliveryText`
- `unitWeight`
- `status`
- `descriptionUrl`
- `isAd`
- `keyword`
- `searchKeyword`
- `position`
- `page`
- `source`
- `detailsFetched`
- `url`
- `scrapedAt`

### Why use the 1688.com Products Scraper

The 1688.com Products Scraper is a 1688.com scraper and 1688.com data extractor for anyone who needs public 1688.com products as clean data. The 1688.com Products Scraper handles web scraping, proxy rotation and retries for you, so you get a ready dataset instead of raw pages. Use the 1688.com Products Scraper for market research, competitor analysis, lead generation, analytics or monitoring, and export the results to JSON, CSV, Excel or Google Sheets.

- No login and no code: the 1688.com Products Scraper runs on Apify with one click or one API call.
- Pay per result: the 1688.com Products Scraper charges only for rows delivered - no monthly 1688.com API fee.
- Complete fields: the 1688.com Products Scraper returns every public field, with a stable schema for automation.
- Integrations: connect the 1688.com Products Scraper to Zapier, Make, n8n, Google Sheets, a webhook or your CRM.

### 1688.com Products Scraper use cases

- Market research: the 1688.com Products Scraper collects 1688.com products at scale, so you can compare trends across weeks and niches.
- Competitor analysis: run the 1688.com Products Scraper on a schedule and export the dataset to Google Sheets or Excel to watch what competitors publish.
- Lead generation and B2B prospecting: the 1688.com Products Scraper gives a sales or agency team a clean list to load into a CRM.
- Content and social media monitoring: the 1688.com Products Scraper keeps a fresh copy of 1688.com data through an Apify schedule and a webhook.
- Analytics and dashboards: send the 1688.com Products Scraper output as JSON through the Apify API into Python, Node.js or a BI tool.
- Academic and data science projects: the 1688.com Products Scraper returns a consistent schema, ready for pandas, R or a notebook.
- Price, product and brand tracking: the 1688.com Products Scraper turns public 1688.com data into a dataset you can diff run by run.
- Automation workflows: connect the 1688.com Products Scraper to Zapier, Make or n8n so every new row starts your next step.

### How to run it with the API, Python and Node.js

Start the 1688.com Products Scraper from the Apify Console, or call it from code. The 1688.com Products Scraper returns its dataset as JSON, CSV or Excel. With the Apify API you can run the 1688.com Products Scraper from Python or Node.js, wait for it to finish and read the rows, which makes the 1688.com Products Scraper easy to plug into an automation, a data pipeline or a scheduled export.

1. Open the 1688.com Products Scraper on Apify and fill in the input (or send the same input as JSON to the API).
2. Start the 1688.com Products Scraper. Follow the run log while the 1688.com Products Scraper collects public 1688.com data.
3. Download the dataset as CSV, JSON, Excel or XLSX, or let a webhook send it on.
4. Schedule the 1688.com Products Scraper to keep your 1688.com data fresh for monitoring and analytics.

### Tips for better results

- Start small: run the 1688.com Products Scraper with a low maximum first, check the fields, then scale up the same input.
- Split big jobs: several smaller 1688.com Products Scraper runs (by keyword, URL list or date) finish faster and are easier to resume.
- Keep a history: name a dataset or use a schedule so each 1688.com Products Scraper run adds to your 1688.com data over time.
- Filter early: use the input filters of the 1688.com Products Scraper so you only pay for the 1688.com products you really need.
- Automate the hand-off: a webhook or the Zapier and Make integrations can move every 1688.com Products Scraper result straight to Google Sheets, a CRM or a database.
- Watch the run log: the 1688.com Products Scraper writes what it is doing and why an item was skipped, so a surprising result is easy to explain.

### 1688.com Products Scraper FAQ

#### Is it legal to scrape 1688.com?

The 1688.com Products Scraper collects only publicly available data. If results contain personal data, process it under GDPR or the rules that apply to you, and only for a legitimate purpose.

#### Do I need a 1688.com account or login?

No. The 1688.com Products Scraper works with no login and no cookies. It reads only public data, the same data any visitor can see.

#### Can I schedule it?

Yes. Apify schedules run the 1688.com Products Scraper hourly, daily or weekly, and a webhook can notify your system when new 1688.com data is ready.

#### How much does it cost?

The 1688.com Products Scraper is pay per result: you pay only for the rows you receive, with lower prices on higher Apify plans. You can cap the cost of every run with the maximum cost setting.

#### Can I send the data to my CRM?

Yes. Push 1688.com Products Scraper rows to HubSpot, Salesforce, Pipedrive or any CRM through Zapier, Make or a webhook - a common setup for an agency or B2B sales team.

#### Which formats can I download?

The 1688.com Products Scraper dataset downloads as JSON, CSV, Excel (XLSX), XML, RSS or an HTML table, and the Apify API returns the same 1688.com Products Scraper data page by page.

#### How is this different from other 1688.com scrapers?

The 1688.com Products Scraper combines complete public fields, no login, pay-per-result pricing and a stable output schema, so the 1688.com Products Scraper fits both quick one-off exports and long-running automation.

#### Can it replace the official 1688.com API?

For public data, yes. The 1688.com Products Scraper gives you 1688.com data through the Apify API without an official 1688.com API key, quota approval or developer account.

#### Can I run it for many inputs at once?

Yes. Give the 1688.com Products Scraper a list of inputs in one run; each row says which input it came from, so one 1688.com Products Scraper run can cover a whole list.

#### Can I export the results to Excel, CSV or Google Sheets?

Yes. Every 1688.com Products Scraper run stores a dataset you can export as CSV, JSON, Excel (XLSX), XML or HTML, or send to Google Sheets with the Apify integration.

#### How fast is it?

The 1688.com Products Scraper runs requests in parallel and rotates proxy sessions automatically, so a typical run of a few hundred items finishes in minutes.

#### Do you offer custom scrapers?

Yes. If you need a field or a filter the 1688.com Products Scraper does not have yet, contact Neuro Scraper through the Apify Store page and we can extend the 1688.com Products Scraper for you.

#### What happens if a run is interrupted?

The 1688.com Products Scraper saves its progress, so a resurrected or restarted run continues where it stopped instead of paying for the same rows again.

#### How do I get more results?

Raise the maximum items, add more inputs (keywords, URLs or profiles), or run the 1688.com Products Scraper several times on a schedule. Results are de-duplicated.

#### What does this 1688.com scraper do?

The 1688.com Products Scraper collects public 1688.com products and returns it as a structured dataset. It is web scraping without code: you set the input, start the 1688.com Products Scraper and download JSON, CSV, Excel or XLSX.

#### What is the best 1688.com scraper for products?

The 1688.com Products Scraper is built for exactly this job: public 1688.com products, complete fields, no login, pay per result and a clean export to JSON, CSV or Excel.

#### Why is a field empty in my results?

The 1688.com Products Scraper fills every field 1688.com publishes for that item. When 1688.com does not show a value - for example a figure the owner hid - the field stays empty rather than being guessed.

#### Does it work with proxies?

Yes. The 1688.com Products Scraper uses Apify Proxy by default and you can pick the proxy group or country in the input.

### Get started

Open the 1688.com Products Scraper, paste your input and press Start. In a few minutes the 1688.com Products Scraper hands you clean 1688.com data as JSON, CSV or Excel, ready for analytics, monitoring, research or your CRM. Questions or a missing field? Write to us from the 1688.com Products Scraper page on Apify - we answer fast and add features users ask for.

### More scrapers from Neuro Scraper

| Actor | What it extracts |
|---|---|
| ⭐ **[Facebook Reels Scraper](https://apify.com/neuro-scraper/facebook-reels-scraper)** | Facebook Reels with exact views, plays, every reaction type, comments and shares |
| [Snapchat Profile Scraper](https://apify.com/neuro-scraper/snapchat-profile-scraper) | Snapchat profile data with all public fields, exported to JSON, CSV or Excel |
| [Amazon Scraper](https://apify.com/neuro-scraper/amazon-keyword-scraper) | Amazon data with all public fields, exported to JSON, CSV or Excel |
| [Instagram Reels Scraper](https://apify.com/neuro-scraper/instagram-reels-scraper) | Instagram reels with all public fields, exported to JSON, CSV or Excel |
| [Facebook Video Details Scraper](https://apify.com/neuro-scraper/facebook-video-details-scraper) | Facebook video details with all public fields, exported to JSON, CSV or Excel |
| [Facebook Reels Scraper Advanced](https://apify.com/neuro-scraper/facebook-reels-scraper-advanced) | Facebook reels  advanced data with all public fields, exported to JSON, CSV or Excel |
| [Facebook Reels Downloader](https://apify.com/neuro-scraper/facebook-reels-downloader) | Facebook reels with all public fields, exported to JSON, CSV or Excel |
| [Instagram Search Scraper](https://apify.com/neuro-scraper/instagram-video-scraper-advanced) | Instagram search data with all public fields, exported to JSON, CSV or Excel |
| [TikTok Video Details Scraper](https://apify.com/neuro-scraper/tiktok-video-details-scraper) | TikTok video details with all public fields, exported to JSON, CSV or Excel |
| [Instagram Hashtag Scraper](https://apify.com/neuro-scraper/instagram-reeel-scraper) | Instagram hashtag data with all public fields, exported to JSON, CSV or Excel |
| [TikTok Profile Scraper](https://apify.com/neuro-scraper/tiktok-profile-scraper) | TikTok profile data with all public fields, exported to JSON, CSV or Excel |
| [Amazon Best Sellers Scraper](https://apify.com/neuro-scraper/amazon-per-result-scraper) | Amazon best sellers with all public fields, exported to JSON, CSV or Excel |
| [Facebook Photos Scraper](https://apify.com/neuro-scraper/facebook-photo-posts-scraper) | Facebook photos with all public fields, exported to JSON, CSV or Excel |

# Actor input Schema

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

What you would type into the 1688 search box, one per line. Chinese keywords work best (English works too, with fewer related searches). Each keyword reads 1688's public sponsored-results page (20 offers) and, if more are wanted, 1688's own related searches that contain your keyword. Example: 手机壳

## `offerIds` (type: `array`):

1688 offer IDs (the number in detail.1688.com/offer/<ID>.html), one per line. Each one gives one product row with every field. Example: 927875250705

## `offerUrls` (type: `array`):

1688 product page URLs such as https://detail.1688.com/offer/927875250705.html (m.1688.com offer links work too). One product row each.

## `maxProducts` (type: `integer`):

How many products to return for each keyword. The first 20 come from the keyword's own results page; more come from 1688's related searches (see below). Example: 20

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

Maximum number of product rows for the whole run (all keywords and offers together). Example: 50

## `expandRelatedKeywords` (type: `boolean`):

1688 shows 20 offers per keyword page to logged-out visitors and its next-page request is signed, so more results are taken from the related searches 1688 lists on the page (only those that contain your keyword, e.g. 苹果手机壳 for 手机壳). Off = at most 20 per keyword.

## `maxRelatedKeywords` (type: `integer`):

Safety limit on related-search pages read per keyword (one request each). Example: 10

## `includeDetails` (type: `boolean`):

For keyword results: open every product's page to add price tiers, MOQ, stock, unit weight, category, attributes, review count and good rate, seller details, location (province / city), delivery promise and services. One extra request per product. Offer IDs / URLs always get full details.

## `includeSkuDetails` (type: `boolean`):

Add skuProps (option names and values with images) and skus (each variant's spec, stock, sales, promotion flag and package size). Needs product pages (on for offer IDs / URLs, or with full details).

## `includeDescriptionHtml` (type: `boolean`):

Download each product's description (one extra small request) and add descriptionHtml, descriptionImages and descriptionText. Many 1688 descriptions are images only, so descriptionText is often empty.

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

Order of the returned products per keyword. 1688's logged-out results page ignores sort parameters (measured), so the Actor collects up to twice the wanted number of offers first and sorts them itself. Example: priceAsc

## `priceMin` (type: `integer`):

Keyword results only: skip offers whose lowest price is below this (checked by the Actor - 1688's logged-out page ignores price parameters). 0 = no minimum. Example: 5

## `priceMax` (type: `integer`):

Keyword results only: skip offers whose lowest price is above this (checked by the Actor). 0 = no maximum. Example: 50

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

Keyword results only: skip offers whose minimum order quantity is higher than this (read from the product page, so product pages are opened). 0 = any MOQ. Example: 10

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

Keyword results only: keep offers from 1688 Verified / Powerful merchants (实力商家) or Super Factories (超级工厂), as shown by 1688's own badges on the offer.

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

Keyword results only: keep offers shipped from this province, in Chinese as on 1688 (广东, 浙江, 福建 ...). Read from the product page. Empty = any. Example: 广东

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

Keyword results only: keep offers shipped from this city, in Chinese (义乌, 深圳, 广州 ...). Read from the product page. Empty = any. Example: 深圳

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

Residential proxy in China is the default (1688 is a Chinese domestic site; China and Hong Kong residential IPs were measured to work). A slider page is never answered - the Actor switches to a new IP instead.

## Actor input object example

```json
{
  "keywords": [
    "手机壳"
  ],
  "maxProducts": 20,
  "maxItems": 50,
  "expandRelatedKeywords": true,
  "maxRelatedKeywords": 10,
  "includeDetails": true,
  "includeSkuDetails": false,
  "includeDescriptionHtml": false,
  "sortBy": "relevance",
  "priceMin": 0,
  "priceMax": 0,
  "minOrderQuantity": 0,
  "merchantType": "any",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CN"
  }
}
```

# 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 = {
    "keywords": [
        "手机壳"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "CN"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuro-scraper/1688-com-products-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 = {
    "keywords": ["手机壳"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "CN",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("neuro-scraper/1688-com-products-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 '{
  "keywords": [
    "手机壳"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CN"
  }
}' |
apify call neuro-scraper/1688-com-products-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neuro-scraper/1688-com-products-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/gsOHFRg7t2guh2Hb0/builds/D9hJTO6UFkGWvoS7K/openapi.json
