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

## API Overview

- Search for 1688 products by image
- Support multiple languages

## API URL

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

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| img_url | string | Image URL<br/>**Only images from Alibaba-affiliated platforms can be identified.**<br/>Non-Ali image needs to be converted using [Image URL conversion API](/docs/ali/tool-apis/image-url-convert.md) first, and then use the converted image URL to call this API. | true |
| page | integer | Page number<br/>Default value: 1 | false |
| page_size | integer | Number of items per page<br/>Default value: 20<br/>Max: 20. | false |
| language | string | Optional values: `en`, `zh`, `ru`, `th`, `pt`, `es`, `tr`, `vi`, `ja`, `ko`<br/>Default value: en | false |
| sort | string | Optional values: `default`, `sales`, `price_up`, `price_down`<br/>Default value: default | 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?apiToken=xxxxxx&img_url=https%3A%2F%2Fcbu01.alicdn.com%2Fimg%2Fibank%2FO1CN01Lnbnos2LkORtHhOVp_%21%213367999730-0-cib.jpg&page=1&page_size=20&language=en&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 2,
    "total_count": 666,
    "sort": "default",
    "filters": {},
    "items": [
      {
        "item_id": 865835426638,
        "product_url": "https://detail.1688.com/offer/865835426638.html",
        "title": "Applicable to Huawei Folding Novaflip Bell N3 Bracelet Mix Phone Case P50pocket2 Protective Case Vflip",
        "title_origin": "适用华为折叠Novaflip铃铛N3手绳Mix手机壳P50Pocket2保护套VFlip",
        "img": "https://cbu01.alicdn.com/O1CN01MJvUUV26UATGC9C8o_!!2407317664-0-cib.jpg",
        "category_path": [
          "1042207",
          "50911",
          "7"
        ],
        "price": "19.00",
        "price_info": {
          "drop_ship_price": "19.00",
          "wholesale_price": "19.00",
          "origin_price": "19.00"
        },
        "brand": "yot",
        "title_tags": [
          "1688严选"
        ],
        "quantity_begin": 1,
        "quantity_prices": [
          {
            "begin_num": "1",
            "end_num": "",
            "price": "19.00"
          }
        ],
        "sale_info": {
          "gmv_fuzzy": "50+",
          "gmv_30days": 0,
          "gmv_30days_cb": 0,
          "sale_quantity": 27,
          "sale_quantity_month": 3,
          "sale_quantity_90days": 12,
          "sale_quantity_360days": 27,
          "orders_count": 13
        },
        "type": "normal",
        "delivery_info": {
          "area_from": [
            "Guangdong",
            "Futian District, Shenzhen"
          ],
          "weight": 0,
          "suttle_weight": 0,
          "free_postage": false
        },
        "item_repurchase_rate": "0.0",
        "goods_score": 2,
        "image_dsm_score": 0,
        "primary_rank_score": 0,
        "super_new_product": false,
        "shop_info": {
          "login_id": null,
          "member_id": "b2b-2407317664",
          "company_name": "xxxxxx",
          "shop_url": "http://880755.1688.com",
          "biz_type": "生产加工",
          "is_factory": true,
          "is_super_factory": false,
          "is_gold_supplier": false,
          "location": [
            "Guangdong",
            "Futian District, Shenzhen"
          ],
          "service_tags": [
            "7×24H响应",
            "先采后付"
          ],
          "tp_member": true,
          "tp_year": 11,
          "factory_inspection": false,
          "shop_repurchase_rate": "11.2%"
        }
      },
      {
        "item_id": 866011508042,
        "product_url": "https://detail.1688.com/offer/866011508042.html",
        "title": "Applicable to Huawei P50pocket Mobile Phone Shell Folding Screen Pocket2 Red Polka Dot Bow Bracelet Protective Cover",
        "title_origin": "适用华为P50Pocket手机壳折叠屏Pocket2红色波点蝴蝶结手链保护套",
        "img": "https://cbu01.alicdn.com/O1CN01yNpkgG1BxXm6UG4jT_!!2923750012-0-cib.jpg",
        "category_path": [
          "1042207",
          "50911",
          "7"
        ],
        "price": "20.00",
        "price_info": {
          "drop_ship_price": "12.00",
          "wholesale_price": "20.00",
          "origin_price": "20.00"
        },
        "brand": "中性",
        "title_tags": [],
        "quantity_begin": 2,
        "quantity_prices": [],
        "sale_info": {
          "gmv_fuzzy": "40+",
          "gmv_30days": 0,
          "gmv_30days_cb": 0,
          "sale_quantity": 18,
          "sale_quantity_month": 2,
          "sale_quantity_90days": 14,
          "sale_quantity_360days": 18,
          "orders_count": 5
        },
        "type": "normal",
        "delivery_info": {
          "area_from": [
            "Guangdong",
            "Bao'an District, Shenzhen City"
          ],
          "weight": 0,
          "suttle_weight": 0,
          "free_postage": false
        },
        "item_repurchase_rate": "0.5",
        "goods_score": 2,
        "image_dsm_score": 0,
        "primary_rank_score": 0,
        "super_new_product": false,
        "shop_info": {
          "login_id": null,
          "member_id": "b2b-2923750012d6f68",
          "company_name": "xxxxxx",
          "shop_url": "http://keshentai.1688.com",
          "biz_type": "生产加工",
          "is_factory": false,
          "is_super_factory": false,
          "is_gold_supplier": false,
          "location": [
            "Guangdong",
            "Bao'an District, Shenzhen City"
          ],
          "service_tags": [],
          "tp_member": true,
          "tp_year": 9,
          "factory_inspection": false,
          "shop_repurchase_rate": "29.2%"
        }
      }
    ]
  }
}

```