# 1688 API - Get the products of a 1688 shop(By shop URL)

## API Overview

- Get all products from 1688 shop by shop URL
- Support sorting
- See More

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| shop_url | string | Shop home page link | 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`, `time_up`, `time_down`<br/>Default value: default | false |
| cat | string | Category ID | false |
| cat_type | string | Optional values: `0`, `1` | 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/shop/items/v2?apiToken=xxxxxx&shop_url=https%3A%2F%2Fxldjjg.1688.com%2F&page=1&page_size=20&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 3,
    "total_count": 162,
    "cat_id": "",
    "sort": "default",
    "items": [
      {
        "item_id": "765000043412",
        "title": "左手理发牙剪 CNC牙剪打薄剪 左手剪刀专业理发美发牙剪 理发店",
        "img": "https:////cbu01.alicdn.com/img/ibank/O1CN01LwXIfD1F0EqsmPKl9_!!1000960424-0-cib.jpg",
        "category_path": [],
        "category_name": "",
        "price": "298.00",
        "quantity": null,
        "sale_info": {
          "sale_quantity": 1,
          "sale_amount": 0
        }
      },
      {
        "item_id": "609958065284",
        "title": "彩色双尾宠物美容剪刀6.5寸狗狗修毛剪宠物小弯剪直剪精修剪工厂",
        "img": "https:////cbu01.alicdn.com/img/ibank/2020/070/565/15608565070_756644553.jpg",
        "category_path": [],
        "category_name": "",
        "price": "155.00",
        "quantity": null,
        "sale_info": {
          "sale_quantity": 7,
          "sale_amount": 0
        }
      },
      {
        "item_id": "662615039902",
        "title": "6寸 平剪无痕牙剪专业发型师用美发剪刀理发店剪发套装 厂家直销",
        "img": "https:////cbu01.alicdn.com/img/ibank/O1CN01LCVGxy1F0EelJM1c6_!!1000960424-0-cib.jpg",
        "category_path": [],
        "category_name": "",
        "price": "105.00",
        "quantity": null,
        "sale_info": {
          "sale_quantity": 58,
          "sale_amount": 0
        }
      }
    ]
  }
}

```