# 1688 API - Search for 1688 products by keywords(Multilingual version)

## API Overview

- Search for 1688 products by keywords
- Support multiple languages
- See More

## API URL

`GET https://api.tmapi.io/1688/global/search/items`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| page | integer | Page number<br/>Default value: 1 | false |
| page_size | integer | Number of items per page<br/>Default value: 20 | false |
| keyword | string | Search keywords | false |
| language | string | Optional values: `en`, `zh`, `ru`, `vi`, `ja`, `ko`<br/>Default value: en | 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 |
| cat_id | integer | Category ID | 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 |

> At least one of [object Object] or [object Object] is required.

## 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/global/search/items?apiToken=xxxxxx&page=1&page_size=20&keyword=%E9%A9%AC%E5%85%8B%E6%9D%AF&language=en&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 2,
    "has_next_page": true,
    "sort": "price_up",
    "filters": {},
    "items": [
      {
        "item_id": "850588705676",
        "product_url": "https://detail.1688.com/offer/850588705676.html",
        "title": "Cross Border DuPont Paper Jelly Bag Tote Bag Large Capacity PVC Waterproof Tote Bag Commuter Mommy Shoulder Bag",
        "title_origin": "跨境杜邦纸果冻包 托特包 大容量PVC防水手提袋 通勤妈咪单肩包包",
        "img": "https://cbu01-overseas.1688.com/img/ibank/O1CN01gcU0Tq1f5tqLKLfHI_!!2216856833956-0-cib.jpg",
        "price": "35.0",
        "price_info": {
          "price": "35.0",
          "price_min": "35.0",
          "price_max": "35.0"
        },
        "currency": "CNY",
        "quantity_begin": "1",
        "sale_info": {
          "sale_quantity_90days": "2880"
        },
        "goods_score": "5.0",
        "shop_info": {
          "is_gold_manufacturer": false,
          "is_verified": false
        },
        "is_free_shipping": false,
        "is_new_item": false,
        "is_hot_item": false
      },
      {
        "item_id": "811949286969",
        "product_url": "https://detail.1688.com/offer/811949286969.html",
        "title": "70th Anniversary Dragon Bag Nylon Dumpling Bag Large Capacity Women's Bag Canvas Tote Bag Single Shoulder Handbag Dragon Bag",
        "title_origin": "70周年龙骧包尼龙饺子包大容量女包包帆布托特包单肩手提包龙骧包",
        "img": "https://cbu01-overseas.1688.com/img/ibank/O1CN01O5qYiF1q5P7aAs7gm_!!2217496155444-0-cib.jpg",
        "price": "54.0",
        "price_info": {
          "price": "54.0",
          "price_min": "54.0",
          "price_max": "54.0"
        },
        "currency": "CNY",
        "quantity_begin": "1",
        "sale_info": {
          "sale_quantity_90days": "2235"
        },
        "goods_score": "4.9",
        "shop_info": {
          "is_gold_manufacturer": false,
          "is_verified": false
        },
        "is_free_shipping": false,
        "is_new_item": false,
        "is_hot_item": false
      }
    ]
  }
}

```