Products API overview
Unified product API for 1688, Taobao, and Weidian. Pass channel on search/detail, or use URL parse for auto-detection.
Prices are CNY yuan — no currency param, no FX conversion. Set language in the JSON body (Languages). Use response_format: "standard" (default) or "upstream" (Response format).
Endpoint guide
| Topic | Endpoint | Doc |
|---|---|---|
| Product detail & SKU matrix | POST /v1/products/detail | Product detail |
| Keyword search | POST /v1/products/search | Product search |
| Upload image for reuse | POST /v1/products/upload-image | Upload image |
| Search by image | POST /v1/products/search-by-image | Image search |
| Parse product URL | POST /v1/products/parse | Parse URL |
| Response schemas | — | Product response models |
| Channels, freight, analytics | various | Advanced endpoints |
Channel capabilities
Query live flags: GET /v1/products/channels. Summary:
| Capability | 1688 | Taobao | Weidian |
|---|---|---|---|
| Detail | ✓ | ✓ | ✓ |
| Keyword search | ✓ | ✓ | — |
| Image search | ✓ | ✓ | — |
| URL parse | ✓ | ✓ | ✓ |
Taobao口令 (tao_password) | — | ✓ | — |
| Domestic freight estimate | ✓ | ✓ | — |
| Auto purchase (orders) | ✓ | ✓ | Varies |
Procurement mapping {#procurement-mapping}
After variant selection on product detail, map ids to order lines:
| Detail field | Order field |
|---|---|
source_product_id | lines[].offer_id |
variants[].sku_id | lines[].spec_id |
See Order preview for the full create flow.