# 1688 API - Search for 1688 products by keywords
## API Overview
- Search for 1688 products by keywords
- Support sorting and filtering
- See More
## API URL
`GET https://api.tmapi.io/1688/search/items`
## Request Parameters
### Query
| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| page | integer | Page number
Default value: 1 | false |
| page_size | integer | Number of items per page
Default value: 20
Max: 20. | false |
| keyword | string | Search keywords | true |
| sort | string | Optional values: `default`, `sales`, `price_up`, `price_down`
Default value: default | false |
| moq | integer | | false |
| price_start | string | Filter: Minimum value of price range | false |
| price_end | string | Filter: Maximum value of price range | false |
| new_arrival | boolean | Filter: New product | false |
| support_dropshipping | boolean | Filter: Supports dropshipping | false |
| free_shipping | boolean | Filter: Free shipping | false |
| is_super_factory | boolean | | false |
## Security Auth
> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.
> Add your apiToken to the request parameters. Please refer to the examples below.
## Request Example
```bash
curl --request GET 'https://api.tmapi.io/1688/search/items?apiToken=xxxxxx&page=1&page_size=20&keyword=%E9%A9%AC%E5%85%8B%E6%9D%AF&sort=default'
```
## Response Example
```json
{
"code": 200,
"msg": "success",
"data": {
"page": 1,
"page_size": 20,
"total_count": 2000,
"keyword": "男士T恤",
"sort": "default",
"cat_id": null,
"filters": {},
"items": [
{
"item_id": 973927556856,
"product_url": "https://detail.1688.com/offer/973927556856.html",
"title": "【高端系列】双面液氨丝光&80高支莱赛尔长袖T恤男士纯色高端上衣",
"img": "https://cbu01.alicdn.com/img/ibank/O1CN01BJ7AAS1YRF4K6UTS4_!!2209657723055-0-cib.jpg",
"category_path": [
"315",
"10165"
],
"price": "56",
"price_info": {
"sale_price": "56",
"origin_price": null
},
"moq": 2,
"quantity_prices": [
{
"begin_num": 2,
"end_num": 199,
"price": "56.00"
},
{
"begin_num": 200,
"end_num": 499,
"price": "55.00"
},
{
"begin_num": 500,
"end_num": null,
"price": "54.00"
}
],
"sale_info": {
"sale_quantity": "已售300+件",
"sale_quantity_int": 300,
"orders_count": 271
},
"delivery_info": {
"area_from": [
"广东",
"广州市"
]
},
"item_repurchase_rate": "12%",
"rating_star": "3.0",
"shop_info": {
"login_id": "广州淘圣男装有限公司",
"member_id": "b2b-2209657723055e41d3",
"company_name": "广州淘圣制衣有限公司",
"shop_url": "http://shop5o52040l89801.1688.com",
"biz_type": "生产加工",
"is_factory": true,
"is_super_factory": false,
"location": [
"广东",
"广州市"
],
"service_tags": [
"深度验厂"
],
"shop_years": 6,
"factory_inspection": true,
"score_info": {
"composite_score": "4.0",
"consultation_score": "4.0",
"dispute_score": "4.0",
"logistics_score": "4.0",
"return_score": "3.33"
}
},
"is_ad": false
},
{
"item_id": 915310259717,
"product_url": "https://detail.1688.com/offer/915310259717.html",
"title": "夏季短袖T恤男士新款纯色圆领半袖上衣青年休闲百搭打底潮牌体恤",
"img": "https://cbu01.alicdn.com/img/ibank/O1CN01BjeeDf1ulmL44FKMD_!!2219543586078-0-cib.jpg",
"category_path": [
"315",
"10165"
],
"price": "8.9",
"price_info": {
"sale_price": "8.9",
"origin_price": null
},
"moq": 1,
"quantity_prices": [
{
"begin_num": 1,
"end_num": 999,
"price": "8.90"
},
{
"begin_num": 1000,
"end_num": 9999,
"price": "8.40"
},
{
"begin_num": 10000,
"end_num": null,
"price": "7.90"
}
],
"sale_info": {
"sale_quantity": "已售200+件",
"sale_quantity_int": 200,
"orders_count": 133
},
"delivery_info": {
"area_from": [
"广东",
"揭阳市"
]
},
"item_repurchase_rate": "9%",
"rating_star": "2.33",
"shop_info": {
"login_id": "悦装服装实业有限公司",
"member_id": "b2b-221954358607802711",
"company_name": "揭阳市悦装服装实业有限公司",
"shop_url": "http://shop511x48z085525.1688.com",
"biz_type": "生产加工",
"is_factory": true,
"is_super_factory": true,
"location": [
"广东",
"揭阳市"
],
"service_tags": [
"深度验厂"
],
"shop_years": 1,
"factory_inspection": true,
"score_info": {
"composite_score": "4.0",
"consultation_score": "2.0",
"dispute_score": "4.0",
"logistics_score": "3.43",
"return_score": "4.67"
}
},
"is_ad": false
},
{
"item_id": 807891725157,
"product_url": "https://detail.1688.com/offer/807891725157.html",
"title": "男士短袖t恤冰丝短袖男T恤衫夏季圆领打底衫休闲百搭帅气短t恤男",
"img": "https://cbu01.alicdn.com/img/ibank/O1CN01hRRR7b29pBJfx3iGE_!!2213001588116-0-cib.jpg",
"category_path": [
"315",
"10165"
],
"price": "6",
"price_info": {
"sale_price": "6",
"origin_price": null
},
"moq": null,
"quantity_prices": [],
"sale_info": {
"sale_quantity": "全网4.1万+件",
"sale_quantity_int": 41000,
"orders_count": 2043
},
"delivery_info": {
"area_from": [
"广东",
"揭阳市"
]
},
"item_repurchase_rate": "8%",
"rating_star": "2.67",
"shop_info": {
"login_id": "天勤服装厂",
"member_id": "b2b-2213001588116f72ee",
"company_name": "揭阳市巨牛服饰有限公司",
"shop_url": "http://shop522427252cui2.1688.com",
"biz_type": "生产加工",
"is_factory": true,
"is_super_factory": true,
"location": [
"广东",
"揭阳市"
],
"service_tags": [
"深度验厂"
],
"shop_years": 5,
"factory_inspection": true,
"score_info": {
"composite_score": "4.5",
"consultation_score": "4.0",
"dispute_score": "4.0",
"logistics_score": "3.43",
"return_score": "4.67"
}
},
"is_ad": false
}
],
"has_next_page": true
}
}
```