# 1688 API - Search for 1688 products by image

## API Overview

- Search for 1688 products by image URL
- Support sorting and filtering
- See More

## API URL

`GET https://api.tmapi.io/1688/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 |
| 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/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&sort=default'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "page": 1,
    "page_size": 20,
    "total_count": 680,
    "keyword": "",
    "sort": "default",
    "cat_id": null,
    "filters": {},
    "items": [
      {
        "item_id": 983093623752,
        "product_url": "https://detail.1688.com/offer/983093623752.html",
        "title": "跨境外贸lulu男士同款运动长袖户外健身速干T恤弹力休闲上衣",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01vGCPtN22CzDpG7RBW_!!2210992147085-0-cib.jpg",
        "category_path": [
          "1031887",
          "127890013",
          "18"
        ],
        "price": "27.00",
        "price_info": {
          "sale_price": "27.00",
          "origin_price": "27.00"
        },
        "moq": 1,
        "quantity_prices": [],
        "sale_info": {
          "sale_quantity": "5160",
          "sale_quantity_int": 5160,
          "orders_count": 111
        },
        "delivery_info": {
          "area_from": [
            "广东",
            "东莞市"
          ]
        },
        "item_repurchase_rate": "54%",
        "rating_star": null,
        "shop_info": {
          "login_id": "瑜佃工厂",
          "member_id": "b2b-2210992147085de3df",
          "company_name": "广东瑜佃供应链管理有限公司",
          "shop_url": "http://gdytgc.1688.com?tracelog=p4p",
          "biz_type": "生产加工",
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "广东",
            "东莞市"
          ],
          "service_tags": null,
          "shop_years": 5,
          "factory_inspection": true,
          "score_info": {
            "composite_score": "4.5"
          }
        },
        "is_ad": true
      },
      {
        "item_id": 969462626480,
        "product_url": "https://detail.1688.com/offer/969462626480.html",
        "title": "专业外贸工厂跨境定制亚欧美码简约棉涤休闲插肩袖圆领秋冬男卫衣",
        "img": "https://cbu01.alicdn.com/O1CN01mlPQyb1rrmigLQq2W_!!2219127385685-0-cib.jpg",
        "category_path": [
          "1036995",
          "10165"
        ],
        "price": "80.00",
        "price_info": {
          "sale_price": "80.00",
          "origin_price": "80.00"
        },
        "moq": 1,
        "quantity_prices": [],
        "sale_info": {
          "sale_quantity": "0",
          "sale_quantity_int": 0,
          "orders_count": 0
        },
        "delivery_info": {
          "area_from": [
            "广东",
            "广州市"
          ]
        },
        "item_repurchase_rate": "42%",
        "rating_star": null,
        "shop_info": {
          "login_id": "广州牛恤服饰有限公司",
          "member_id": "b2b-22191273856859f6d3",
          "company_name": "广州牛恤服饰有限公司",
          "shop_url": "http://shop179343015u765.1688.com",
          "biz_type": "生产加工",
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "广东",
            "广州市"
          ],
          "service_tags": null,
          "shop_years": 1,
          "factory_inspection": false,
          "score_info": {
            "composite_score": "4.5"
          }
        },
        "is_ad": false
      },
      {
        "item_id": 964901961900,
        "product_url": "https://detail.1688.com/offer/964901961900.html",
        "title": "明格|美式潮牌百搭拼接圆领卫衣男士秋季新款宽松休闲长袖上衣男",
        "img": "https://cbu01.alicdn.com/O1CN01cAb4CX1N4puhfi8ut_!!2216055311517-0-cib.jpg",
        "category_path": [
          "1036995",
          "10165"
        ],
        "price": "51.00",
        "price_info": {
          "sale_price": "51.00",
          "origin_price": "51.00"
        },
        "moq": 1,
        "quantity_prices": [],
        "sale_info": {
          "sale_quantity": "88",
          "sale_quantity_int": 88,
          "orders_count": 79
        },
        "delivery_info": {
          "area_from": [
            "广东",
            "广州市"
          ]
        },
        "item_repurchase_rate": "46%",
        "rating_star": null,
        "shop_info": {
          "login_id": "广州明格服装",
          "member_id": "b2b-221605531151756a4e",
          "company_name": "广州市明格服装有限公司",
          "shop_url": "http://shop6c79789c1c537.1688.com",
          "biz_type": "生产加工",
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "广东",
            "广州市"
          ],
          "service_tags": null,
          "shop_years": 3,
          "factory_inspection": false,
          "score_info": {
            "composite_score": "5.0"
          }
        },
        "is_ad": false
      }
    ],
    "has_next_page": true
  }
}

```