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"

Request

Query Params

appKey

string

required

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.

imageUrl

string

required

Image URL: Only 1688 image links are supported for query scenarios. No data guaranteed for other sources.

Example:

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

imageId

string

optional

One of the parameters image_id or pic_url must be provided. If both are specified, the value of image_id takes precedence.

Example:

1048608196202797156

beginPage

integer

required

page

Example:

pageSize

integer

required

Pagination: Max 50, recommended 20

Example:

region

string

optional

Image subject selection by bounding box coordinates, e.g., (x1, y1, x2, y2) = (266, 799, 48, 581)

filter

string

optional

Filter parameters: Multiple values should be separated by commas. For enumerations, refer to the Solution Introduction.

sort

string

optional

Sort parameters: For enumerations, refer to the Solution Introduction.

Example:

{"price":"asc"}

outMemberId

string

optional

This field (uid) is optional for external users and can be left blank.

priceStart

string

optional

Price Start: The minimum price value used for filtering.

Example:

priceEnd

string

optional

Price End: The maximum price value used for filtering.

Example:

20000

categoryId

integer

optional

Filter items by Category ID

imageAddress

string

optional

Image URL: Only 1688 image links are supported for query scenarios. No data guaranteed for other sources.

country

string

required

Country represents language. For detailed enumerations, refer to the Developer Reference menu.

Example:

keyword

string

optional

Filter items by keyword

auxiliaryText

string

optional

Multimodal Image Search with Text

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

code

integer

required

返回码

message

string

required

消息

data

object

required

业务消息

totalRecords

integer

required

总数量

totalPage

integer

required

总页数

pageSize

integer

required

分页

currentPage

integer

required

分页

data

array [object {11}]

required

数据

picRegionInfo

object

required

主体信息

timestamp

integer

required

时间戳

traceId

string

required

traceId

Example

{
  "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参数不正确