1688 APIdetail.1688.com ↗
Fetch product titles, pricing tiers, SKU variants, seller info, and drop-shipping data from 1688.com listings via 10 structured endpoints.
What is the 1688 API?
The 1688.com Product Detail API exposes 10 endpoints covering every major data section of a 1688.com product listing — from tier pricing and SKU variant maps to seller badges and drop-shipping channel availability. Pass a numeric offer ID or a full product URL to get_product_details and receive title, image arrays, price range, sales count, physical weight/measurements, and a seller summary in one call.
curl -X GET 'https://api.parse.bot/scraper/bb0ade25-1595-4730-86be-b24affd889da/get_product_details?offer_id=573787401272' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches comprehensive product details for a 1688.com listing including title, images, seller summary, price range, sales count, product attributes, and the listing's published physical weight and measurements. Single-page response per offer ID. The weight_measurements object carries the seller-declared unit weight in kilograms (unit_weight_kg), per-SKU weights in kilograms keyed by SKU id when the seller declares them (sku_weights_kg, empty object otherwise), and one or more measured pieces (pieces) with length_cm, width_cm, height_cm, volume_cbm (cubic metres, converted from the listing's cm³ value) and weight_kg (converted from the listing's gram value); a dimension the seller left unfilled arrives as 0.0 exactly as the site publishes it, and a measurement whose unit label on the site is not recognised arrives as null. weight_measurements is null when the listing publishes neither a unit weight nor a piece measurement table. Rate-limited: one request per IP before antibot triggers.
| Param | Type | Description |
|---|---|---|
| offer_idrequired | string | Numeric product offer ID (e.g. '573787401272') or full 1688.com product URL containing the offer ID. |
{
"type": "object",
"fields": {
"unit": "string, sales unit",
"title": "string, product title",
"images": "array of image objects with fullPathImageURI and size variants",
"seller": "object with company_name, login_id, member_id",
"offer_id": "string, the offer ID",
"sale_num": "integer, total sales count",
"attributes": "array of product attribute objects with name and value",
"main_images": "array of main image objects with fullPathImageURI",
"price_range": "object with min and max price strings",
"weight_measurements": "object or null: unit_weight_kg (number, kg), sku_weights_kg (object keyed by SKU id, kg), pieces (array of {length_cm, width_cm, height_cm, volume_cbm, weight_kg}; 0.0 = not filled by seller), source_columns (the site's raw column labels/units for the measurement table)"
},
"sample": {
"data": {
"unit": "对",
"title": "原宿风简约几何圆形磨砂梦幻星空时光宝石满天星不锈钢耳钉 12MM",
"images": [
{
"imageURI": "img/ibank/9108903206_2130544268.jpg",
"summImageURI": "https://cbu01.alicdn.com/img/ibank/9108903206_2130544268.summ.jpg",
"searchImageURI": "https://cbu01.alicdn.com/img/ibank/9108903206_2130544268.search.jpg",
"fullPathImageURI": "https://cbu01.alicdn.com/img/ibank/9108903206_2130544268.jpg",
"size220x220ImageURI": "https://cbu01.alicdn.com/img/ibank/9108903206_2130544268.220x220.jpg",
"size310x310ImageURI": "https://cbu01.alicdn.com/img/ibank/9108903206_2130544268.310x310.jpg"
}
],
"seller": {
"login_id": "qingwensp",
"member_id": "qingwensp",
"company_name": "义乌市怡雯饰品有限公司"
},
"offer_id": "573787401272",
"sale_num": null,
"attributes": [
{
"fid": 287,
"name": "材质",
"vids": [
42752
],
"value": "不锈钢",
"values": [
"不锈钢"
],
"isSpecial": false,
"lectotype": false,
"outputType": 0,
"decisionValues": [
"不锈钢"
],
"itemCpvDecision": true
}
],
"main_images": [
{
"imageURI": "img/ibank/9108903206_2130544268.jpg",
"fullPathImageURI": "https://cbu01.alicdn.com/img/ibank/9108903206_2130544268.jpg"
}
],
"price_range": {
"max": "1.00",
"min": "1.00"
},
"weight_measurements": {
"pieces": [
{
"width_cm": 0,
"height_cm": 0,
"length_cm": 0,
"weight_kg": 0.004,
"volume_cbm": 0
}
],
"sku_weights_kg": {},
"source_columns": [
{
"name": "length",
"label": "长(cm)",
"precision": 2
},
{
"name": "width",
"label": "宽(cm)",
"precision": 2
},
{
"name": "height",
"label": "高(cm)",
"precision": 2
},
{
"name": "volume",
"label": "体积(cm³)",
"precision": 3
},
{
"name": "weight",
"label": "重量(g)",
"precision": 0
}
],
"unit_weight_kg": 0.004
}
},
"status": "success"
}
}About the 1688 API
Product Data and Pricing
get_product_details accepts either a numeric offer_id (e.g. '573787401272') or a full 1688.com product URL and returns the product title, main_images, a price_range object with min and max strings, total sale_num, and a weight_measurements object carrying unit_weight_kg, per-SKU weights keyed by SKU ID, and piece-level dimensions in centimeters. get_product_pricing isolates the pricing layer, returning a price_model with a currentPrices array of quantity-break tiers, begin_amount for the minimum order quantity, and the full sku_map with per-variant prices. This makes it straightforward to display tiered wholesale pricing without parsing the full product record.
Variants, Attributes, and Colors
get_product_variants returns a props array of SKU property groups — each with a prop name and value options that may include an imageUrl — alongside a sku_map keyed by SKU ID containing price, canBookCount (stock), specAttrs, and skuId. get_product_attributes returns all specification fields as an array of objects with fid, name, and value, covering material, brand, origin, and similar factory-spec metadata. get_product_color_codes isolates the color dimension of the variant tree, returning each color's name, associated image URL, and id.
Seller and Distribution Data
get_seller_info returns companyName, loginId, memberId, userId, winportUrl (the seller's shop URL), and a sellerSign object carrying badge metadata. get_drop_shipping_info exposes distributeChannels — an array of platform objects with name and typeCode covering Taobao, Douyin, Amazon, Shopee, and others — plus consignOffer and hasConsignPrice booleans indicating whether the listing supports consignment fulfillment.
Full-Record Fetch
get_all_product_info returns all nine data sections — details, pricing, variants, attributes, color_codes, seller_info, packing_info, detail_images, and drop_shipping_info — in a single response. This costs two fetches internally rather than nine-plus, making it the practical choice when building a product importer or catalog sync that needs the complete record for each offer ID.
The 1688 API is a managed, monitored endpoint for detail.1688.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when detail.1688.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official detail.1688.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Sync 1688.com wholesale catalog listings into a Shopify or WooCommerce store using title, images, and per-SKU pricing from
get_product_variants. - Build a MOQ and tier-price calculator for sourcing agents using the
currentPricesarray andbegin_amountfromget_product_pricing. - Populate a cross-border fulfillment tool with drop-shipping channel eligibility and consignment terms from
get_drop_shipping_info. - Construct a product weight and dimension estimator for freight quoting using
unit_weight_kgand piece measurements fromweight_measurements. - Aggregate supplier identity data (company name, shop URL, seller badges) from
get_seller_infofor vendor due-diligence workflows. - Extract color swatch names and images from
get_product_color_codesto generate variant display grids in a buyer-facing catalog. - Pull full product specs from
get_product_attributesto auto-fill material, brand, and origin fields when creating listings on other platforms.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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 `get_product_packing_info` return, and when is it empty?+
get_product_packing_info returns an items array of packing objects with length, width, height, volume, and weight per SKU when the seller has filled in that section of their listing. Many 1688.com sellers leave packing fields blank, so an empty items array is a normal response and not an error condition.Does the API cover customer reviews or Q&A for a listing?+
Can I retrieve multiple product listings in one call?+
offer_id per request; there is no batch parameter. To retrieve multiple listings you need one call per offer ID. get_all_product_info minimizes round-trips per listing by returning all data sections together, but it still operates on one offer ID at a time. You can fork the API on Parse and revise it to add a batch endpoint if your workflow requires fetching many IDs at once.What format does the `offer_id` parameter accept?+
'573787401272') or a full 1688.com product page URL that contains the offer ID. The API parses the numeric ID out of the URL automatically, so both forms produce the same result.