Search 1688 Factory Wholesale Listings & MOQ Price Ladders

GET/v1/1688/search· Updated 2026-11-14

Building cross-border sourcing? Read our 1688 & Taobao MOQ Ladder Guide →

Direct Answer · Commerce Engineering Summary

GET /v1/1688/search queries Alibaba 1688.com factory wholesale offers directly using Chinese or English keywords—requiring zero Chinese domestic proxies, Alipay accounts, or 1688 Open Platform enterprise registration. Each offer includes item_id, title, factory price in CNY plus auto-converted USD, MOQ minimum order quantity, 30-day sales/repurchase signals, and Verified Super Factory badges at 2 Credits per offer.

Honest Trade-Offs & Scope Boundaries

→Chinese keywords (e.g., 陶瓷马克杯, 手机壳) yield the deepest factory recall, though English terms are also supported.
→Search cards return starting wholesale price and MOQ; call GET /v1/1688/item for multi-tier MOQ price breaks (e.g. 2+ / 50+ / 500+ units) and SKU matrices.
→Ex-works (EXW) China factory pricing excludes international freight and customs duties—use our Wholesale Margin Calculator to model landed FBA margin.

Search China 1688.com factory wholesale offers with MOQ tiered prices (CNY & USD), Verified Super Factory badges, repurchase rates, and 30d sales. Cost: 2 Credits / item returned.

Parameters

keywordstringrequired
pageinteger

Example Request (cURL / Python / JavaScript)

curl "https://api.shopdataapi.com/v1/1688/search?keyword=%E9%99%B6%E7%93%B7%E9%A9%AC%E5%85%8B%E6%9D%AF" \
  -H "x-api-key: sd_live_your_api_key"

import requests

res = requests.get(
    "https://api.shopdataapi.com/v1/1688/search?keyword=%E9%99%B6%E7%93%B7%E9%A9%AC%E5%85%8B%E6%9D%AF",
    headers={"x-api-key": "sd_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.shopdataapi.com/v1/1688/search?keyword=%E9%99%B6%E7%93%B7%E9%A9%AC%E5%85%8B%E6%9D%AF", {
  headers: { "x-api-key": "sd_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Response Fields

Normalized 1688 wholesale offer list with MOQ tiers.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`status`	string	Example: ok
`msg`	string	Example: success
`meta`	object
`marketplace`	string
`count`	integer
`credits_per_item`	integer	Example: 2
`data`	array of ShopProduct
`marketplace`	"amazon" \| "walmart" \| "etsy" \| "1688" \| "taobao" \| "shopee" \| "tiktok_shop" \| "facebook_marketplace"
`item_id`	string	Example: B0CRMP3RQT
`asin`	stringnull	Example: B0CRMP3RQT
`country`	string	Example: US
`title`	string	Example: OWALA SmoothSip Insulated Stainless Steel Coffee Tumbler, 20
`url`	string	Example: https://www.amazon.com/dp/B0CRMP3RQT
`brand`	stringnull	Example: Owala
`category`	stringnull	Example: Kitchen & Dining > Travel Mugs
`price`	numbernull	Example: 24.99
`list_price`	numbernull	Example: 29.99
`currency`	string	Example: USD
`price_usd`	numbernull	Example: 24.99
`wholesale_tiers`	array of WholesaleTier
`min_qty`	integer	Example: 50
`max_qty`	integernull	Example: 499
`label`	string	Example: 50–499 pcs
`unit_price`	number	Example: 8.5
`currency`	string	Example: CNY
`unit_price_usd`	number	Example: 1.18
`moq`	integernull	Example: 2
`rating`	numbernull	Example: 4.8
`reviews_count`	integer	Example: 8420
`sales_volume`	stringnull	Example: 10K+ bought in past month
`monthly_sales_est`	integernull	Example: 10000
`is_prime`	boolean	Example: true
`is_best_seller`	boolean	Example: true
`in_stock`	boolean	Example: true
`seller_name`	stringnull	Example: Amazon.com
`verified_supplier`	boolean	Example: false
`repurchase_rate`	stringnull	Example: 38%
`main_image`	stringnull
`images`	array of string
`sku_matrix`	array of SkuOption
`sku_id`	string	Example: B0CRMP3RQT-BLK
`attributes`	object	Example: [object Object]
`price`	numbernull	Example: 24.99
`currency`	string	Example: USD
`in_stock`	boolean	Example: true
`stock_qty`	integernull	Example: 420
`image_url`	stringnull
`badges`	array of string

Status Codes

200: Normalized 1688 wholesale offer list with MOQ tiers.