s.1688.com APIs.1688.com ↗
Search 1688.com wholesale products, fetch SKU pricing tiers, and retrieve customer reviews via 3 structured endpoints covering China's largest B2B marketplace.
curl -X GET 'https://api.parse.bot/scraper/aa6e2b5e-7963-46f5-a6c2-e326775ceae4/search_products?page=1&query=shoes' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on 1688 by keyword. Returns a paginated list of product offers with seller info, pricing, and location.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword (Chinese or English) |
{
"type": "object",
"fields": {
"page": "integer current page number",
"items": "array of product objects with offerId, title, price, loginId, sellerName, bookedCount, province, city, url",
"total": "integer total number of results",
"hasMore": "boolean indicating if more pages are available"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://detail.1688.com/offer/659219381085.html",
"city": "福州市",
"price": "1.99",
"title": "库存拖鞋slippers人字拖鞋夏季凉拖鞋批发跨境拖鞋女拖鞋女外穿",
"loginId": "fuyanfootwear",
"offerId": 659219381085,
"province": "福建",
"sellerName": "福州市福燕鞋业有限公司",
"bookedCount": "0"
}
],
"total": 2000,
"hasMore": true
},
"status": "success"
}
}About the s.1688.com API
The s.1688.com API provides 3 endpoints covering product search, detailed SKU data, and customer reviews from China's largest B2B wholesale marketplace. The search_products endpoint returns paginated results with offer IDs, seller names, pricing, and geographic location, while get_product_detail exposes full SKU model data including pricing tiers, variant properties, and promotion info — giving developers structured access to supplier and product data without manual browsing.
Search and Discovery
The search_products endpoint accepts a query string (Chinese or English) and an optional page integer for pagination. Each result object includes offerId, title, price, loginId, sellerName, bookedCount, province, city, url, and a hasMore flag alongside the total count. The bookedCount field indicates order volume and is useful for gauging supplier activity. Geographic fields (province, city) help identify where the seller operates within China.
Product Detail and SKU Modeling
The get_product_detail endpoint takes an offer_id (the numeric offerId from search results) and returns the full skuModel object. This object contains SKU selector data covering pricing tiers, variant properties (such as size or color), associated images, trade model constraints, and active promotion info. Pricing tiers are a core part of 1688 wholesale listings, where unit cost typically decreases at higher quantity thresholds.
Customer Reviews
The get_product_reviews endpoint requires both an offer_id and a login_id — the seller's login identifier returned in search_products results. It returns a reviews array and a headers metadata object. Note that the reviews array may be empty if a product has no recorded reviews. Pagination is supported via the page parameter. The login_id dependency means you must either run a search or fetch product detail before calling reviews.
- Compare unit pricing tiers across multiple 1688 suppliers for the same product category using
skuModeldata fromget_product_detail. - Build a supplier shortlist by filtering
search_productsresults byprovinceorcityto find geographically clustered manufacturers. - Track
bookedCountacross keyword searches to identify high-demand wholesale products. - Aggregate customer reviews from
get_product_reviewsto score supplier reliability before placing bulk orders. - Map
offerIdtosellerNameandloginIdfor structured supplier databases populated from search results. - Monitor SKU variant availability and promotional pricing changes by polling
get_product_detailfor specific offer IDs. - Seed a product catalog with wholesale pricing from 1688.com by combining search pagination with per-offer detail lookups.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does 1688.com have an official developer API?+
What does the `skuModel` object in `get_product_detail` actually contain?+
skuModel object includes SKU selector data covering pricing tiers (wholesale quantity brackets), variant properties such as size or color, images tied to specific SKU combinations, the trade model (e.g. minimum order quantities), and any active promotion info. It is the primary source for per-variant pricing on a 1688 listing.Why does `get_product_reviews` require a `login_id` in addition to an `offer_id`?+
login_id is the seller's account identifier and is returned in the loginId field of search_products results. You need to run a search or hold a prior result to supply this parameter when calling the reviews endpoint.Does the API return seller certification, business license, or factory audit data?+
Are there limitations on review data availability?+
reviews array can be empty if a product has no posted reviews, which is common for newer or lower-volume listings on 1688.com. The endpoint does not distinguish between a product with zero reviews and one where reviews are restricted — both return an empty array. Pagination via page applies only when reviews exist.