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

## API Overview

- Search for 1688 products by image
- Supports more languages compared to V1
- Support sorting and filtering
- See More

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| language | string | Optional values: `en`, `zh`, `ru`, `vi`, `ja`, `ko`<br/>Default value: en | false |
| img_url | string | Image URL | 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 |
| support_dropshipping | boolean | Filter: Supports dropshipping | false |
| is_factory | boolean | Filter: Is factory | false |
| verified_supplier | boolean | Filter: Verified supplier | false |
| free_shipping | boolean | Filter: Free shipping | false |
| new_arrival | boolean | Filter: New product | 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/global/search/image/v2?apiToken=xxxxxx&language=en&img_url=%2Fsearch%2Fimgextra5%2F1589508648580602236.jpg&page=1&page_size=20&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 10,
    "total_count": 688,
    "keyword": "",
    "sort": "default",
    "cat_id": null,
    "filters": {
      "price_start": "2"
    },
    "items": [
      {
        "item_id": 908305897124,
        "product_url": "https://detail.1688.com/offer/908305897124.html",
        "title": "2024 New Yinxing Classmate Red Lotus Seed Glutinous Jianning Old Variety Red Lotus Seed Core White Lotus Seed 500g",
        "title_origin": "2024年新印兴同学红花莲子糯建宁老品种红花莲子通芯白莲子500g",
        "img": "https://cbu01.alicdn.com/O1CN01OfUGyD2ILFvHYpyMS_!!3264309269-0-cib.jpg",
        "category_path": [
          "130822002",
          "104"
        ],
        "price": "60.00",
        "price_info": {
          "price": "60.00",
          "sale_price": "60.00",
          "origin_price": ""
        },
        "currency": "CNY",
        "moq": null,
        "sale_info": {
          "sale_quantity_90days": "0"
        },
        "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": 9,
          "score_info": {
            "composite_score": "4.0"
          }
        },
        "item_repurchase_rate": "0%",
        "low_refund_rate": false,
        "ship_in_48h": false,
        "one_piece_min_order": false
      },
      {
        "item_id": 819919675160,
        "product_url": "https://detail.1688.com/offer/819919675160.html",
        "title": "Factory Fresh Lotus Seeds Cored White Lotus Dry Goods 500g Customized Wholesale Bagged Bulk Sulfur-Free White Lotus Seeds",
        "title_origin": "工厂新鲜莲子去芯通芯白莲 干货500克定制批发袋装散装无硫白莲子",
        "img": "https://cbu01.alicdn.com/O1CN01o6YOrC2N1Aoq4PiO9_!!2216045399902-0-cib.jpg",
        "category_path": [
          "130822002",
          "10020"
        ],
        "price": "40.80",
        "price_info": {
          "price": "40.80",
          "sale_price": "40.80",
          "origin_price": ""
        },
        "currency": "CNY",
        "moq": null,
        "sale_info": {
          "sale_quantity_90days": "3"
        },
        "delivery_info": {
          "area_from": [
            "湖南",
            "湘潭市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "shop_info": {
          "company_name": "湘潭荣欣食品有限公司",
          "is_powerful_seller": true,
          "is_super_factory": false,
          "shop_years": 3,
          "score_info": {
            "composite_score": "4.0"
          }
        },
        "item_repurchase_rate": "0%",
        "low_refund_rate": false,
        "ship_in_48h": false,
        "one_piece_min_order": false
      },
      {
        "item_id": 923701239315,
        "product_url": "https://detail.1688.com/offer/923701239315.html",
        "title": "Jianning Lotus Seeds 250g Peeled White Lotus Seeds Sulfur-Free Natural Color Four Treasure Porridge Hehe Herbal Free Shipping",
        "title_origin": "建宁莲子250克去皮心白莲建莲子无硫本色四宝粥禾和本草包邮",
        "img": "https://cbu01.alicdn.com/O1CN0189swY92JcUB9T4N4g_!!649399442.jpg",
        "category_path": [
          "2",
          "201164002"
        ],
        "price": "54.69",
        "price_info": {
          "price": "54.69",
          "sale_price": "54.69",
          "origin_price": ""
        },
        "currency": "CNY",
        "moq": null,
        "sale_info": {
          "sale_quantity_90days": "0"
        },
        "delivery_info": {
          "area_from": [
            "河北",
            "邢台市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "shop_info": {
          "company_name": "清河县怀驰贸易行",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "shop_years": 1,
          "score_info": {
            "composite_score": "3.5"
          }
        },
        "item_repurchase_rate": "0%",
        "low_refund_rate": false,
        "ship_in_48h": true,
        "one_piece_min_order": false
      }
    ],
    "has_next_page": true
  }
}

```