1688 ค้นหาภาพสินค้า

请求参数

Header 参数

access-key

string

必需

默认值:

58c0201dfdf148eca63cbf6bb5e7cf03

nonce-str

string

可选

默认值:

nonce-str

timestamp

string

必需

默认值:

1715669977082

user-id

string

必需

默认值:

2100007341207

signature

string

必需

默认值:

B7F83FE2ADC8D8F044F2E01F0FFE8C80

Body 参数application/json

imageBase64

string | null

必需

图片base64，主要要去掉头部的【data:image/jpeg;base64,】

beginPage

integer | null

第几页

必需

pageSize

integer | null

分页大小

必需

country

string | null

目前固定传 en

必需

region

string | null

主体选择

可选

filter

string | null

可选

筛选参数，多个通过英文逗号分隔，枚举：shipInToday,ksCiphertext

sort

string | null

可选

排序参数，枚举：{"price":"asc"}

priceStart

string | null

最小批发价

可选

priceEnd

string | null

最大批发价

可选

categoryId

integer | null

类目id

可选

imageAddress

string | null

可选

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

outMemberId

string | null

外部用户id

可选

示例

{
    "imageBase64": "xxxx",
    "beginPage": 1,
    "pageSize": 5,
    "country": "en",
    "imageAddress": "https://cbu01.alicdn.com/img/ibank/O1CN01Gf8JoQ20i0lN5N8v2_!!2207943566882-0-cib.jpg",
    "outMemberId": "21000070000"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v2/alibaba/product/image/query' \
--header 'access-key;' \
--header 'nonce-str: nonce-str' \
--header 'timestamp;' \
--header 'user-id;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageBase64": "xxxx",
    "beginPage": 1,
    "pageSize": 5,
    "country": "en",
    "imageAddress": "https://cbu01.alicdn.com/img/ibank/O1CN01Gf8JoQ20i0lN5N8v2_!!2207943566882-0-cib.jpg",
    "outMemberId": "21000070000"
}'

返回响应

🟢200成功

application/json

Body

requestId

string

请求ID

可选

code

integer

返回码

可选

developId

integer

开发者ID

可选

msg

string

返回码对应信息

可选

data

object (AlibabaBasePageVOAlibabaProductListInfoV2VO)

返回内容

可选

totalRecords

integer

总记录数

可选

totalPage

integer

总页数

可选

pageSize

integer

分页大小

可选

currentPage

integer

第几页

可选

data

array[object (AlibabaProductListInfoV2VO) {8}]

分页数据

可选

示例

{
    "requestId": "09f06e9131854474b8ded98d94df98ae",
    "code": 200,
    "developId": "1110890638347337996",
    "msg": "成功",
    "data": {
        "totalRecords": 687,
        "totalPage": 137,
        "pageSize": 5,
        "currentPage": 1,
        "data": [
            {
                "imageUrl": "https://cbu01.alicdn.com/O1CN01ddr4sG20i0lNyQDzs_!!2207943566882-0-cib.jpg",
                "subject": "国潮男装t恤230g重磅短袖男女纯棉体恤宽松圆领团服打底衫衣服潮",
                "subjectTrans": "T-shirt men's national tide 230g heavy cotton Xinjiang cotton tide brand printable logo loose ins solid color short sleeve wholesale",
                "offerMapId": "wmNAp5CyEQ2fatKAZGGMWQ",
                "isJxhy": true,
                "priceInfo": {
                    "price": "16.00",
                    "jxhyPrice": null,
                    "pfJxhyPrice": null
                },
                "repurchaseRate": "5%",
                "monthSold": 97822
            },
            {
                "imageUrl": "https://cbu01.alicdn.com/O1CN01j4fU0a1weZ8pmlCkl_!!2212789706333-0-cib.jpg",
                "subject": "T恤男五分袖夏季潮牌百搭ins宽松情侣圆领体恤上衣打底衫短袖女",
                "subjectTrans": "T-shirt Men's Half Sleeve Summer Trendy Brand All-match Ins Loose Couple's Round Neck T-shirt Top Base Shirt Short Sleeve Women",
                "offerMapId": "faAiBEuMLWM5IscSXkFk4Q",
                "isJxhy": true,
                "priceInfo": {
                    "price": "5.86",
                    "jxhyPrice": "5.86",
                    "pfJxhyPrice": "5.86"
                },
                "repurchaseRate": "41%",
                "monthSold": 6088
            },
            {
                "imageUrl": "https://cbu01.alicdn.com/O1CN01QsQrF51rMBFD6T05h_!!2214894045616-0-cib.jpg",
                "subject": "夏季纯色230g重磅纯棉打底衫男 定制白色休闲百搭圆领短袖t恤女朝",
                "subjectTrans": "Summer solid color 230g heavy cotton bottoming shirt men's custom white casual Joker crew neck short sleeve T-shirt women",
                "offerMapId": "OHIf1Eto5Nah_LvqhTevdA",
                "isJxhy": false,
                "priceInfo": {
                    "price": "15.90",
                    "jxhyPrice": null,
                    "pfJxhyPrice": null
                },
                "repurchaseRate": "23%",
                "monthSold": 17312
            },
            {
                "imageUrl": "https://cbu01.alicdn.com/O1CN01Ojx0py1grovLB7MSu_!!2219212114196-0-cib.jpg",
                "subject": "夏季230G纯棉宽松短袖t恤男 代发水云棉纯色男女同款上衣打底衫潮",
                "subjectTrans": "Summer 230G Cotton Loose Short-sleeved T-shirt Men's Daisuyun Cotton Solid Color Men's and Women's Same Top Base Shirt Trendy",
                "offerMapId": "szc8JpIx46jBL5aCy-KEww",
                "isJxhy": false,
                "priceInfo": {
                    "price": "15.90",
                    "jxhyPrice": null,
                    "pfJxhyPrice": null
                },
                "repurchaseRate": "8%",
                "monthSold": 11094
            },
            {
                "imageUrl": "https://cbu01.alicdn.com/O1CN01SBAoQV2Leu0KfeRKu_!!2218427659718-0-cib.jpg",
                "subject": "白色短袖T恤男士港风夏季宽松韩版中袖纯色体恤五分袖学生大码半",
                "subjectTrans": "White Short-sleeved T-shirt Men's Hong Kong-style Summer Loose Korean-style Mid-sleeved Solid Color T-shirt Half-sleeved Student plus size",
                "offerMapId": "FIhjWsBFgrPOJYk-iPjZYw",
                "isJxhy": false,
                "priceInfo": {
                    "price": "5.00",
                    "jxhyPrice": null,
                    "pfJxhyPrice": null
                },
                "repurchaseRate": "16%",
                "monthSold": 567
            }
        ]
    }
}