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 |
| Similar products (Taobao) | POST /v1/products/similar | Advanced endpoints |
| 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 |
|---|---|
id (1688 offerId; Taobao mi_id) | lines[].id (compatible: offer_id, Taobao mi_id) |
source_product_id (1688 same as id; Taobao = item_id) | 1688 only as a compatible id / offer_id |
variants[].sku_id | lines[].spec_id |
See Order preview for the full create flow.
Taobao
id/mi_idrotates periodically. Do not cache it long-term, or detail / similar / order calls will fail. Re-fetch before checkout.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days