Image search - English

Product image search supports multi-language returns. Please contact customer service to activate multiple languages.
English: "en", Russian: "ru", Vietnamese: "vi", Japanese: "ja", Korean: "ko", French: "fr", Portuguese: "pt", Spanish: "es"

请求参数

Query 参数

appKey

string

必需

大吉平台appKey

appSecret

string

可选

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

sign

string

可选

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

imageUrl

string

商品图片链接

必需

示例值:

https://cbu01.alicdn.com/img/ibank/O1CN01zEkk4m1ruzEhY7QF1_!!2207950555692-0-cib.jpg

imageId

string

可选

片ID与pic_url参数二选一，优先取image_id值

示例值:

1048608196202797156

beginPage

integer

分页

必需

示例值:

pageSize

integer

必需

分页，最大不超过50，建议20效果最佳

示例值:

region

string

主体选择

可选

filter

string

可选

筛选参数，多个通过英文逗号分隔，枚举参见解决方案介绍

sort

string

可选

排序参数，枚举参见解决方案介绍

示例值:

{"price":"asc"}

outMemberId

string

外部用户uid

可选

priceStart

string

批发价开始

可选

示例值:

priceEnd

string

批发价结束

可选

示例值:

20000

categoryId

integer

类目id

可选

imageAddress

string

可选

图片地址，仅使用1688图片链接查询场景，其他不保证有数据返回

country

string

必需

如en-英语，详细枚举请参考开发人员参考菜单

示例值:

keyword

string

在结果中搜索

可选

auxiliaryText

string

多模态图搜文案

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

消息

必需

data

object

业务消息

必需

totalRecords

integer

总数量

必需

totalPage

integer

总页数

必需

pageSize

integer

分页

必需

currentPage

integer

分页

必需

data

array [object {11}]

数据

必需

picRegionInfo

object

主体信息

必需

timestamp

integer

时间戳

必需

traceId

string

traceId

必需

示例

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "totalRecords": 700,
    "totalPage": 175,
    "pageSize": 4,
    "currentPage": 1,
    "data": [
      {
        "imageUrl": "https://cbu01.alicdn.com/O1CN01n1LVNC23jmxwE47az_!!2200710277292-0-cib.jpg",
        "subject": "直筒修身男士休闲裤夏季薄款冰丝速干夏天男装潮牌运动九分西裤子",
        "subjectTrans": "Straight Slim Men's Casual Pants Summer Thin Ice Silk Quick-drying Summer Men's Fashion Brand Sports Cropped Western Pants",
        "priceInfo": {
          "price": "34.50",
          "jxhyPrice": "34.50",
          "pfJxhyPrice": "34.5",
          "consignPrice": "34.50"
        },
        "offerId": 727920485853,
        "isJxhy": true,
        "repurchaseRate": "5%",
        "monthSold": 3911,
        "traceInfo": "object_id%40727920485853%5Eobject_type%40offer%5Etrace%4021668b5717207775052062103e13a4%5EimageInfo%401404308150809095588%5EoutMemberId%40null",
        "isOnePsale": true,
        "sellerIdentities": [
          "tp_member"
        ]
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/O1CN01xMGBeR2JOIJiBdCcu_!!2217545629411-0-cib.jpg",
        "subject": "啄木鸟男士冰丝短袖T恤夏季薄款宽松休闲运动男装上衣服网眼速干",
        "subjectTrans": "Woodpecker Men's Ice Silk Short-sleeved T-shirt Summer Thin Loose Casual Sports Men's Clothes Mesh Quick-drying",
        "priceInfo": {
          "price": "38.00",
          "jxhyPrice": null,
          "pfJxhyPrice": null,
          "consignPrice": "38.00"
        },
        "offerId": 778343967028,
        "isJxhy": false,
        "repurchaseRate": "26%",
        "monthSold": 9,
        "traceInfo": "object_id%40778343967028%5Eobject_type%40offer%5Etrace%4021668b5717207775052062103e13a4%5EimageInfo%401404308150809095588%5EoutMemberId%40null",
        "isOnePsale": true,
        "sellerIdentities": [
          "tp_member"
        ]
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/O1CN014OmIyN2CBHlm72JXQ_!!2214505488435-0-cib.jpg",
        "subject": "纯棉工装短裤男士夏季美式休闲五分裤子男生帅气百搭运动外穿中裤",
        "subjectTrans": "Pure Cotton Tooling Shorts Men's Summer American Casual Five-point Pants Boys Handsome All-match Sports Outer Wear Pants",
        "priceInfo": {
          "price": "38.00",
          "jxhyPrice": null,
          "pfJxhyPrice": null,
          "consignPrice": "38.00"
        },
        "offerId": 793097846055,
        "isJxhy": false,
        "repurchaseRate": "7%",
        "monthSold": 540,
        "traceInfo": "object_id%40793097846055%5Eobject_type%40offer%5Etrace%4021668b5717207775052062103e13a4%5EimageInfo%401404308150809095588%5EoutMemberId%40null",
        "isOnePsale": true,
        "sellerIdentities": [
          "tp_member"
        ]
      },
      {
        "imageUrl": "https://cbu01.alicdn.com/O1CN01DLnSp01p6wr2j8ovd_!!2081435312-0-cib.jpg",
        "subject": "休闲裤冰丝男士夏季薄款束脚宽松速干青少年2024新款九分运动裤子",
        "subjectTrans": "Casual Pants Ice Silk Men's Summer Thin Leg Loose Quick-drying Teenagers 2024 New Arrival Nine-point Sports Pants",
        "priceInfo": {
          "price": "48.00",
          "jxhyPrice": null,
          "pfJxhyPrice": null,
          "consignPrice": "48.00"
        },
        "offerId": 788934039984,
        "isJxhy": false,
        "repurchaseRate": "13%",
        "monthSold": 15,
        "traceInfo": "object_id%40788934039984%5Eobject_type%40offer%5Etrace%4021668b5717207775052062103e13a4%5EimageInfo%401404308150809095588%5EoutMemberId%40null",
        "isOnePsale": true,
        "sellerIdentities": [
          "powerful_merchants",
          "tp_member"
        ]
      }
    ],
    "picRegionInfo": {
      "currentRegion": "0,799,0,799",
      "yoloCropRegion": "0,799,0,799"
    }
  },
  "timestamp": 1720777505749,
  "traceId": "9cd9629bcaa2"
}

🟠404记录不存在

🟠400参数不正确