图片搜索V2.0 - 中文版

生产环境请求地址：https://openapi.dajisaas.com/taobao/image-search/url
淘宝图片搜索API升级版

请求参数

Query 参数

appKey

string

可选

大吉平台appKey

appSecret

string

可选

秘钥，仅调试使用，正式用sign签名

sign

string

可选

sign签名，请求的参数字典排序+秘钥appSecret，调试时可忽略改字段

picUrl

string

图片URL

可选

示例值:

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

categoryId

string

可选

图片类目，0-上衣，1-裙装，2-下装，3-包，4-鞋，5-配饰，6-零食，7-美妆，8-瓶饮，9-家具，20-玩具，21-内衣，22-数码硬件，88888888-其他

crop

boolean

可选

是否需要进行主体识别，默认true。

示例值:

true

region

string

可选

图片的主体区域，格式为x1,x2,y1,y2, 其中x1,y1 是左上角的点，x2,y2是右下角的点。

示例值:

66,591,1,417

pageNo

number

可选

返回结果的起始位置。取值范围：0~499。默认值为0。

示例值:

pageSize

number

可选

返回结果的数目。取值范围：1~20。默认值为10。

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

消息

必需

data

object

业务数据

必需

data

array [object {15}]

业务数据

必需

picInfo

object

图片识别信息

必需

pageNo

integer

当前页

必需

pageSize

integer

返回结果的数目

必需

timestamp

integer

时间戳

必需

traceId

string

traceId

必需

示例

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "data": [
            {
                "categoryName": "毛针织衫",
                "couponAmount": null,
                "couponstartFee": null,
                "itemId": "5vg25PnhyfyGY796ABs8OWUMtV-rKDb6GoFM88AoBq0tJx",
                "levelOneCategoryName": "女装/女士精品",
                "picUrl": "//img.alicdn.com/i1/1842082349/O1CN01TaZTFs1TDtBkTpVQY_!!1842082349.jpg",
                "provcity": "广东 东莞",
                "reservePrice": "126",
                "sellerId": "1842082349",
                "shopTitle": "地球店二店",
                "title": "地球店曲珠冰纱红杏格子撞色针织衫女夏短款修身短袖开衫上衣",
                "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DsPdi0PbxKhxw4vFB6t2Z2ueEDrYVVa64fCnEkYHU%2B2tyINtkUhsv0JD0h7euvjG%2F0qJVyTo94ShiXvUzhoKVixRFogLtAy69QVFPeFGc1TY4%2BxSFYMYz7uef9u%2FgPk6%2BwuZCglBRafSRsAn7fTRRs4SeRh9FKRBkkj5FyoqbNBTdSHCHNJOxzncNTgVG4xXbn%2F9QxdlLzUcm9yPfpl2E5xaKQOdSiolIMEhiqT4MmVbov6o3CYoydS%2BdltjzdawQz2TFFEd9SqY%3D&union_lens=lensId%3AOPT%401750244145%4021664a5a_0e5e_19782ae382f_0992%4001%40eyJmbG9vcklkIjo2OTM0OH0ie",
                "userType": 0,
                "volume": 2,
                "zkFinalPrice": "116"
            },
            {
                "categoryName": "马甲",
                "couponAmount": null,
                "couponstartFee": null,
                "itemId": "PX0Z7QQuof6RY5NPdnFVPRiPt6-0Qg9eYjTBmPAZW07Sq",
                "levelOneCategoryName": "童装/婴儿装/亲子装",
                "picUrl": "//img.alicdn.com/i1/2458480306/O1CN012Ah8F71E8CCpQgmPE_!!2458480306.jpg",
                "provcity": "浙江 台州",
                "reservePrice": "29.99",
                "sellerId": "2458480306",
                "shopTitle": "梦逸童装童帽",
                "title": "女宝宝千鸟格外搭开衫长袖红色针织秋冬开衫马甲韩版加厚外套女童",
                "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DBnEpRO0zAyRw4vFB6t2Z2ueEDrYVVa64fCnEkYHU%2B2tyINtkUhsv0JD0h7euvjG%2F0qJVyTo94ShiXvUzhoKVixRFogLtAy69QVFPeFGc1TY4%2BxSFYMYz7uef9u%2FgPk6%2BwuZCglBRafSRsAn7fTRRs4hGDMsdl3oBdpNYVxgkAahC1m9i8JfCew2MgCj663IeJ1wm7%2BzR52BvMUjsML3%2FlK034r1dA5IPXv8MXErYGf%2Bao8djcsaH5UcQGcijEirPxgxdTc00KD8%3D&union_lens=lensId%3AOPT%401750244145%4021664a5a_0e5e_19782ae382f_0993%4001%40eyJmbG9vcklkIjo2OTM0OH0ie",
                "userType": 0,
                "volume": 1,
                "zkFinalPrice": "19.99"
            }
        ],
        "picInfo": {
            "mainRegion": {
                "multiCategoryId": [
                    {
                        "categoryId": 0,
                        "score": 0.54708
                    },
                    {
                        "categoryId": 1,
                        "score": 0.14878
                    },
                    {
                        "categoryId": 20,
                        "score": 0.09874
                    },
                    {
                        "categoryId": 21,
                        "score": 0.05279
                    }
                ],
                "region": "66,591,1,417"
            },
            "multiRegion": [
                {
                    "region": "66,591,1,417"
                },
                {
                    "region": "58,516,383,766"
                },
                {
                    "region": "49,654,3,772"
                }
            ]
        },
        "pageNo": 0,
        "pageSize": 2
    },
    "timestamp": 1750244145260,
    "traceId": "bb19c2c5947d"
}