Product keyword search API
POST /v1/products/search — keyword search returning a paginated product list.
Related: Product detail · Product response models
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao |
keyword | Yes | Search term |
page / page_size | No | Pagination (Taobao max 20 per page) |
language | No | Default en |
filter / sort | No | 1688 filters (see OpenAPI) |
Example
POST /v1/products/search
{
"channel": "1688",
"keyword": "phone case",
"page": 1,
"page_size": 20,
"language": "en"
}Response
StandardProductList — summary cards in items[]. items[].id is Taobao mi_id or 1688 offerId; pass it to product detail as id.
Taobao id / mi_id rotates periodically. Do not cache listings long-term; stale ids fail on detail, similar, and orders.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days