Taobao/Tmall Image Search for Similar Products Interface

GET

/rest/taobao-global/traffic/item/imgsearch

Submit non-Ali image URLs via pic_url, which may have a certain failure rate. It is recommended to first call the image upload interface to obtain the image ID, and then query using the image ID. The image search interface does not currently support pagination. Please handle it yourself. Search results support en|vi|ru|ko|ja.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ecommerce-api.shanjing-inc.com/rest/taobao-global/traffic/item/imgsearch?filters=24shipping&excludeFilters=used_item&excludeFilters=customized_item&pic_url=https%3A%2F%2Fimg.alicdn.com%2Fbao%2Fuploaded%2Fi3%2F684174095%2FO1CN019WLF1n1g7YYWtonEu_!!0-item_pic.jpg&include_tags=activity_202311_1_tb_manjian&language=en&image_id=1616108138716568543' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "errorCode": "string",
    "errorMsg": "string",
    "data": [
        {
            "couponPrice": "string",
            "promotionDisplayVOList": [
                {
                    "name": "string",
                    "itemPromotionDisplayInfoVOList": [
                        {
                            "code": "string",
                            "name": "string"
                        }
                    ]
                }
            ],
            "tbItemId": 0,
            "title": "string",
            "mainImageUrl": "string",
            "price": "string",
            "inventory": 0,
            "shopName": "string",
            "tagList": [
                "string"
            ],
            "materialI18nVO": {
                "title": "string",
                "mainImage": "string",
                "language": "string"
            }
        }
    ]
}

🟢200Failed

Modified at 2026-03-14 06:46:03

Taobao/Tmall Product Keyword Search Interface

Upload image to Taobao/Tmall for product search