# 1688 API - Get category products V2

## API Overview

- Retrieve 1688 products by category ID
- Support multilingual output
- Support sorting and filtering

## API URL

`GET https://api.tmapi.io/1688/category/items/v2`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| language | string | Optional values: `en`, `zh`, `ru`, `vi`, `ja`, `ko`<br/>Default value: en | false |
| cat_id | integer | Category ID | true |
| page | integer | Page number<br/>Default value: 1 | false |
| page_size | integer | Number of items per page<br/>Default value: 20 | false |
| sort | string | Optional values: `default`, `sales`, `price_up`, `price_down`<br/>Default value: default | 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/category/items/v2?apiToken=xxxxxx&language=en&cat_id=&page=1&page_size=20&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 20,
    "total_count": 2000,
    "keyword": "",
    "sort": "default",
    "cat_id": 1031922,
    "filters": {},
    "items": [
      {
        "item_id": 991188728585,
        "product_url": "https://detail.1688.com/offer/991188728585.html",
        "title": "2817桃心太阳镜爱心太阳眼镜果冻色无框心型连体眼镜炫目色彩眼镜",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01l1LMMu23dNfRuPnh4_!!2219960167278-0-cib.jpg",
        "category_path": [
          "54",
          "80"
        ],
        "price": "0.60",
        "price_info": {
          "price": "0.60",
          "sale_price": "0.60",
          "origin_price": ""
        },
        "currency": "CNY",
        "moq": "1",
        "quantity_begin": "1",
        "sale_info": {
          "sale_quantity_90days": "100000+"
        },
        "delivery_info": {
          "area_from": [
            "浙江",
            "台州市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "shop_info": {
          "company_name": "台州市路桥喜字电子商务商行",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "shop_years": 1,
          "score_info": {
            "composite_score": "4.0"
          }
        },
        "item_repurchase_rate": "60%",
        "low_refund_rate": false,
        "ship_in_48h": false,
        "one_piece_min_order": false
      },
      {
        "item_id": 740842253828,
        "product_url": "https://detail.1688.com/offer/740842253828.html",
        "title": "2817桃心太阳镜爱心太阳眼镜果冻色无框心型连体眼镜炫目色彩眼镜",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01ngamtu20DmPVLrYzO_!!3961706816-0-cib.jpg",
        "category_path": [
          "54",
          "80"
        ],
        "price": "0.60",
        "price_info": {
          "price": "0.60",
          "sale_price": "0.60",
          "origin_price": ""
        },
        "currency": "CNY",
        "moq": "2",
        "quantity_begin": "2",
        "sale_info": {
          "sale_quantity_90days": "100000+"
        },
        "delivery_info": {
          "area_from": [
            "浙江",
            "台州市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "shop_info": {
          "company_name": "临海市泉森眼镜有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "shop_years": 3,
          "score_info": {
            "composite_score": "4.5"
          }
        },
        "item_repurchase_rate": "57%",
        "low_refund_rate": false,
        "ship_in_48h": false,
        "one_piece_min_order": false
      },
      {
        "item_id": 819097915075,
        "product_url": "https://detail.1688.com/offer/819097915075.html",
        "title": "心型眼镜工厂爱心眼镜糖果果冻色无框心型连体眼镜 炫目色彩眼镜",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01F6AaZL2FUveROQEw9_!!2218247818884-0-cib.jpg",
        "category_path": [
          "54",
          "80"
        ],
        "price": "0.65",
        "price_info": {
          "price": "0.65",
          "sale_price": "0.65",
          "origin_price": ""
        },
        "currency": "CNY",
        "moq": "2",
        "quantity_begin": "2",
        "sale_info": {
          "sale_quantity_90days": "100000+"
        },
        "delivery_info": {
          "area_from": [
            "浙江",
            "台州市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "shop_info": {
          "company_name": "台州市爱昌眼镜有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "shop_years": 2,
          "score_info": {
            "composite_score": "4.5"
          }
        },
        "item_repurchase_rate": "49%",
        "low_refund_rate": false,
        "ship_in_48h": false,
        "one_piece_min_order": false
      }
    ],
    "has_next_page": true
  }
}

```