# China Sourcing Finder: 1688 Factory vs AliExpress Prices (`henrycrawl/china-sourcing-finder`) Actor

One keyword (English, Vietnamese or Chinese) -> the same product on 1688 (factory / wholesale) and AliExpress (retail) in one table: CNY / USD / VND prices, tier prices, MOQ, supplier province, scores, sales, English and Vietnamese titles, landed-cost estimate. Pay per product.

- **URL**: https://apify.com/henrycrawl/china-sourcing-finder.md
- **Developed by:** [Henry Crawl](https://apify.com/henrycrawl) (community)
- **Categories:** E-commerce, AI, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 product founds

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

## China Sourcing Finder: 1688 Factory Prices vs AliExpress, in One Table

**Type what you want to sell — in English, Vietnamese or Chinese — and get the same kind of product from 1688
(Chinese factories and wholesalers) and AliExpress (retail, ships worldwide) side by side**, with prices already
converted to USD, CNY and VND, quantity price tiers, minimum order quantity, supplier province and ratings, sales
counts, titles translated to English and Vietnamese, and an optional landed-cost estimate.

Built for e-commerce sellers, dropshippers, sourcing agents and AI shopping / sourcing agents.

### Why this actor

- **Two marketplaces, one comparable table.** One row format for 1688 and AliExpress, plus one free
  `comparison` row per keyword: min / median / max USD price on each marketplace, the cheapest listing, and how
  many times more AliExpress costs than the factory price.
- **No Chinese needed.** Your keyword is translated to Chinese for 1688 and English for AliExpress; every title
  comes back in English and Vietnamese.
- **Factory data that matters for sourcing:** tier prices (e.g. 2–499 pcs ¥9.00, ≥500 pcs ¥8.20), MOQ, province /
  city, supplier type (manufacturer / trader), years on 1688, factory / business inspection, service scores,
  repurchase rate, units sold.
- **Prices in your currency** at the day's exchange rate (rates used are included in every row).

### Input

```json
{
  "keywords": ["phone case", "ốp lưng điện thoại", "led strip light"],
  "platforms": ["1688", "aliexpress"],
  "maxResultsPerPlatform": 20,
  "sort": "relevance",
  "province1688": "广东",
  "shipTo": "VN",
  "translateTitlesTo": ["en", "vi"],
  "shippingUSDPerUnit": 0.4,
  "importDutyPercent": 10
}
```

### Output

**Product row (1688):**

```json
{
  "type": "product",
  "platform": "1688",
  "keyword": "phone case",
  "searchKeyword": "手机壳",
  "productId": "735353578254",
  "url": "https://detail.1688.com/offer/735353578254.html",
  "title": "适用iphone18PRO大视窗磁吸手机壳…",
  "titleEn": "Large-window magnetic phone case for iPhone 18 Pro…",
  "titleVi": "Ốp điện thoại từ tính cửa sổ lớn cho iPhone 18 Pro…",
  "priceMin": 9, "currency": "CNY", "priceUSD": 1.35, "priceVND": 34650,
  "priceTiers": [{"minQty": 2, "maxQty": 499, "unit": "个", "priceCNY": 9.0, "priceUSD": 1.35, "priceVND": 34650}],
  "moq": 2,
  "soldCount": 19000, "soldText": "已售1.9万+件", "repurchaseRate": "9%",
  "province": "广东", "city": "深圳市",
  "supplier": {"name": "深圳市亿佳合兴科技有限公司", "type": "生产加工", "yearsOnPlatform": 9, "businessInspected": true,
               "scores": {"compositeNewScore": 4.0, "goodsScore": 3.67, "logisticsScore": 3.0}},
  "landedCostEstimate": {"usdPerUnit": 1.885, "vndPerUnit": 48400, "assumes": {"shippingUSDPerUnit": 0.4, "importDutyPercent": 10}}
}
```

**AliExpress rows** carry `priceUSD`, `priceOriginal`, `discountPercent`, `soldCount` and `rating` where AliExpress
shows them, and `freeShipping`.

**Comparison row (free, one per keyword):** `platforms.1688` / `platforms.aliexpress` → `minUSD`, `medianUSD`,
`maxUSD`, `cheapest`; `aliexpressToFactoryMedianRatio`.

### Pricing

**$0.004 per product** (translation and currency conversion included). Comparison and error rows are free.
20 products from each marketplace for one keyword = $0.16.

### Use with AI agents (MCP)

`https://mcp.apify.com/?tools=henrycrawl/china-sourcing-finder` — e.g. `{"keywords": ["yoga mat"], "maxResultsPerPlatform": 10}`.

### Notes

- `landedCostEstimate` is a simple estimate from the numbers you give (shipping per unit, duty %). Check your HS
  code and the destination's current tariffs before buying.
- 1688 prices are factory / wholesale prices before domestic shipping inside China and agent fees.
- Coming next: search by product image, Taobao.

# Actor input Schema

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

What you want to buy, in English, Vietnamese or Chinese (e.g. "phone case", "ốp lưng điện thoại", "手机壳"). It is translated to Chinese for 1688 and English for AliExpress automatically.

## `platforms` (type: `array`):

Where to search. Default: both.

## `maxResultsPerPlatform` (type: `integer`):

Products returned per keyword and marketplace.

## `sort` (type: `string`):

Result order on each marketplace.

## `priceMinCNY` (type: `number`):

Only 1688 offers at or above this unit price.

## `priceMaxCNY` (type: `number`):

Only 1688 offers at or below this unit price.

## `province1688` (type: `string`):

Only suppliers in this province, written in Chinese, e.g. 广东 (Guangdong), 浙江 (Zhejiang), 福建 (Fujian).

## `shipTo` (type: `string`):

Country used for AliExpress prices and availability.

## `translateTitlesTo` (type: `array`):

Add titleEn / titleVi. Default: both.

## `shippingUSDPerUnit` (type: `number`):

Optional. Your shipping cost per unit; adds a landedCostEstimate to every product.

## `importDutyPercent` (type: `number`):

Optional. Import duty + taxes as % of the price at your destination (look up your HS code); used in landedCostEstimate.

## `skipAds` (type: `boolean`):

Drop paid / promoted listings.

## Actor input object example

```json
{
  "keywords": [
    "phone case"
  ],
  "maxResultsPerPlatform": 20,
  "sort": "relevance",
  "shipTo": "US",
  "skipAds": false
}
```

# Actor output Schema

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

Product rows from each marketplace, one free comparison row per keyword, free error rows.

## `summary` (type: `string`):

Counts, exchange rates used (SUMMARY record).

# 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": [
        "phone case"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("henrycrawl/china-sourcing-finder").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": ["phone case"] }

# Run the Actor and wait for it to finish
run = client.actor("henrycrawl/china-sourcing-finder").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": [
    "phone case"
  ]
}' |
apify call henrycrawl/china-sourcing-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,henrycrawl/china-sourcing-finder"
        }
    }
}
```

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/tGM9Tu7BZQzwcf9za/builds/h435rdTVOcOPGJrvm/openapi.json
