Image search V2.0

Production Request URL: https://openapi.dajisaas.com/taobao/image-search/url
This is the upgraded version of the Taobao Image Search API.

Request

Query Params

appKey

string

optional

DAJI AppKey

appSecret

string

optional

appSecret (For Testing Only) – Use the sign signature in production environments.

sign

string

optional

Signature: Sort the request parameters in dictionary order and append the appSecret key. This field can be omitted during testing.

picUrl

string

optional

Image URL

Example:

https://img.alicdn.com/bao/uploaded/i3/684174095/O1CN019WLF1n1g7YYWtonEu_!!0-item_pic.jpg

categoryId

string

optional

Numeric code representing the category of the item in the image. The mapping is as follows:0 – Tops\1 – Dresses\2 – Bottoms\3 – Bags\4 – Shoes\5 – Accessories\6 – Snacks\7 – Beauty Products\8 – Bottled Beverages\9 – Furniture\20 – Toys\21 – Underwear\22 – Digital Devices\88888888 – Others

crop

boolean

optional

Indicates whether subject (main object) detection should be performed. Default is true

Example:

true

region

string

optional

The bounding box of the main subject in the image, formatted as x1,x2,y1,y2, where (x1, y1) represents the coordinates of the top-left corner, and (x2, y2) represents the bottom-right corner.

pageNo

number

optional

Specifies the starting index of the returned results.Valid range: 0–499.Default value: 0.

Example:

pageSize

number

optional

Specifies the number of results to return.Valid range: 1–20.Default value: 10.

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

integer

required

返回码

message

string

required

消息

data

object

required

业务数据

data

array [object {15}]

required

业务数据

picInfo

object

required

图片识别信息

pageNo

integer

required

当前页

pageSize

integer

required

返回结果的数目

timestamp

integer

required

时间戳

traceId

string

required

traceId

Example

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "data": [
            {
                "categoryName": "钢笔",
                "couponAmount": null,
                "couponstartFee": null,
                "itemId": "o5ZMRpZH8fKx57ZyjWhAWYCntN-n4jADGXuxdmxw3aOCz",
                "levelOneCategoryName": "文具电教/文化用品/商务用品",
                "picUrl": "//img.alicdn.com/i2/2127922298/O1CN015WsfNd1SqX6IwXgED_!!0-item_pic.jpg",
                "provcity": "上海",
                "reservePrice": "50",
                "sellerId": "2127922298",
                "shopTitle": "英雄俊行专卖店",
                "title": "英雄359钢笔小学生专用三年级正姿英伦风高颜值练字儿童初学者男女生墨囊钢笔可替换墨水官方旗舰店",
                "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DQzzLVVt6Bd1w4vFB6t2Z2ueEDrYVVa64uiMLTK%2BNwpFyINtkUhsv0FPFix7EDy%2BCCngzq6vh1vFiXvUzhoKVixRFogLtAy69QVFPeFGc1TY4%2BxSFYMYz7uef9u%2FgPk6%2BwuZCglBRafSRsAn7fTRRszOA6o7PfKecil9X6sgcZvnrTlqCLI%2BTfeA46mZ2NlIp4HhdRwUUJVTuXAxwGMkhGj8HpmS5ABoAsCfzKVA2T%2BXOqf2Bpk9TG7%2F3tH9zOC%2FaxgxdTc00KD8%3D&union_lens=lensId%3AOPT%401750257502%400b145535_0e21_197837a07db_549e%4001%40eyJmbG9vcklkIjo2OTM0OH0ie",
                "userType": 1,
                "volume": 9,
                "zkFinalPrice": "22.8"
            },
            {
                "categoryName": "钢笔",
                "couponAmount": null,
                "couponstartFee": null,
                "itemId": "RKRWDq2cafj3Kx4Qv8i4KvHMt6-rKDb6GoFMK34XRQzuJx",
                "levelOneCategoryName": "文具电教/文化用品/商务用品",
                "picUrl": "//img.alicdn.com/i3/1643580314/O1CN01QAQYKq1EBrKlZC176_!!2-item_pic.png",
                "provcity": "四川 成都",
                "reservePrice": "60",
                "sellerId": "1643580314",
                "shopTitle": "名卓甄品旗舰店",
                "title": "英雄牌359钢笔小学生三年级儿童练字专用四年级男女生初学者正姿可替换墨囊笔尖高颜值定制可擦正品官方旗舰",
                "url": "//s.click.taobao.com/t?e=m%3D2%26s%3Dj4qyzuKhx35w4vFB6t2Z2ueEDrYVVa64uiMLTK%2BNwpFyINtkUhsv0FPFix7EDy%2BCCngzq6vh1vFiXvUzhoKVixRFogLtAy69QVFPeFGc1TY4%2BxSFYMYz7uef9u%2FgPk6%2BwuZCglBRafSRsAn7fTRRs%2B8M5o0rX7PKthEZw0YLWtR7NcKmrJ4G%2B5NHQUf9jj98LFWsy3vRPTWz%2BrdbaNQy3BaKQOdSiolIQSWMrxg00cHGBPO2y24NxgvQ1iU7ziTRz2TFFEd9SqY%3D&union_lens=lensId%3AOPT%401750257502%400b145535_0e21_197837a07db_549f%4001%40eyJmbG9vcklkIjo2OTM0OH0ie",
                "userType": 1,
                "volume": 100,
                "zkFinalPrice": "45.6"
            }
        ],
        "picInfo": {
            "mainRegion": {
                "multiCategoryId": [
                    {
                        "categoryId": 88888888,
                        "score": 0.84396
                    },
                    {
                        "categoryId": 22,
                        "score": 0.05508
                    },
                    {
                        "categoryId": 7,
                        "score": 0.0159
                    },
                    {
                        "categoryId": 20,
                        "score": 0.01543
                    }
                ],
                "region": "222,361,34,376"
            },
            "multiRegion": [
                {
                    "region": "222,361,34,376"
                },
                {
                    "region": "155,225,25,372"
                },
                {
                    "region": "194,291,29,371"
                },
                {
                    "region": "108,160,22,369"
                },
                {
                    "region": "58,107,26,365"
                }
            ]
        },
        "pageNo": 0,
        "pageSize": 2
    },
    "timestamp": 1750257502215,
    "traceId": "6d010c4582bf"
}