# 1688 API - Get category products

## API Overview

- Retrieve 1688 products by category ID

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| page | integer | Page number<br/>Default value: 1 | false |
| cat_id | integer | Category ID | true |
| super_factory | boolean | Filter: Super factory | false |
| support_dropshipping | boolean | Filter: Supports dropshipping | false |
| free_shipping | boolean | Filter: Free shipping | 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?apiToken=xxxxxx&page=1&cat_id=1031910'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 2,
    "has_next_page": true,
    "filters": {},
    "items": [
      {
        "item_id": 884674536008,
        "product_url": "https://detail.1688.com/offer/884674536008.html",
        "title": "2025夏季新款温柔碎花法式连衣裙女高级感广州十三行蓬蓬裙子女装",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01n7ZpIr1zyfRRHlyvV_!!2215924096783-0-cib.jpg",
        "price": "",
        "price_info": {
          "sale_price": "4.59",
          "show_price": "4.59",
          "origin_price": "5.40"
        },
        "quantity_begin": 200,
        "sales_count": "180100",
        "sale_info": {
          "sale_quantity_int": 180100,
          "buyer_count": 89750
        },
        "shop_info": {
          "login_id": "衣耘服装厂",
          "shop_url": "https://yiyunfuzhuang888.1688.com",
          "company_name": "广州衣耘服装厂",
          "is_super_factory": false,
          "shop_repurchase_rate": "38.46"
        }
      },
      {
        "item_id": 769734131977,
        "product_url": "https://detail.1688.com/offer/769734131977.html",
        "title": "欧美跨境度假风蕾丝沙滩裙V领镂空开叉连体设计感连衣裙",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01Zq7l8S2EzKFQjexo0_!!1022268815-0-cib.jpg",
        "price": "",
        "price_info": {
          "sale_price": "44.00",
          "show_price": "44.00",
          "origin_price": "44.00"
        },
        "quantity_begin": 3,
        "sales_count": "60627",
        "sale_info": {
          "sale_quantity_int": 60627,
          "buyer_count": 60044
        },
        "shop_info": {
          "login_id": "xiangtongdz",
          "shop_url": "https://xiangtongdz.1688.com",
          "company_name": "广州市昀晟电子科技有限公司",
          "is_super_factory": false,
          "shop_repurchase_rate": "18.18"
        }
      }
    ]
  }
}

```