全部
在线测试
拼多多详情 v2 接口
接口地址： http://api.vv-tool.com/tool/accounts/goods-basic
接口介绍： 拼多多商品详细信息查询点击查看详情
请求方式： GET
返回格式： JSON
接口收费： 查询 1 次，计 1 次调用，找销售可低至几分钱
频率限制： 10 次/秒
回调逻辑：
如果返回的 code 值为 0，表示本次请求成功，请求成功后，进入回调流程，第一次推送失败后，平台后续将以 2 分钟 1 次的频率推送商品详情，推送成功，则停止继续推送。推送 5 次未能成功，则停止推送。
推送的目标地址是客户端通过 notify_url 参数传递过来的回调地址。推送结果数据格式，请参考下面的文档说明。
notify_url 设置的回调地址应该是可公开访问的，而且支持 POST 请求方式。
调用方在回调地址中完成数据接收后，请以 JSON 格式返回值为 true 的 status 字段，表示推送成功，如：
{
"status": true
}
否则，视为推送失败。
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| goods_id | string | 是 | 商品编码 |
| notify_url | string | 是 | 回调地址，接收查询结果推送 |
请求示例
goods_id:478612439006
notify_url:http://api.test.com/xxxx
请求代码示例
cURL请求代码示例
curl --location --request GET 'http://api.vv-tool.com/tool/accounts/goods-basic?notify_url=%20http%3A%2F%2Fapi.test.com/xxxx&goods_id=478612439006' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx' \
--data '{
"notify_url": "http://api.test.com/xxxx",
"goods_id": "478612439006"
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/accounts/goods-basic?notify_url=http%3A%2F%2Fapi.test.com%2Fxxxx&goods_id=478612439006',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_POSTFIELDS =>'{
"notify_url": "http://api.test.com/xxxx",
"goods_id": "478612439006"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx',
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"notify_url\": \"http://your.notify_url/xxx\",\r\n \"goods_id\": \"478612439006\"\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/accounts/goods-basic?notify_url=http://your.notify_url/xxx&goods_id=478612439006")
.method("GET", body)
.addHeader("Content-Type", "application/json")
.addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
.build();
Response response = client.newCall(request).execute();
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| code | int | 返回代码 |
| msg | string | 返回码描述 |
| msec | int | 接口执行时间 |
| time | int | 接口返回时间 |
回调推送的数据
| 参数 | 类型 | 描述 |
|---|---|---|
| mall_id | string | 店铺 id |
| mall_name | string | 店铺名（部分商品返回为空） |
| mall_logo | string | 店铺图片（部分商品返回为空） |
| sales_tip | string | 店铺销量（部分商品返回为空） |
| goods_num | string | 商品数量（部分商品返回为空） |
| goods_num_desc | string | 商品数量（部分商品返回为空） |
| desc_score | string | 店铺评分（部分商品返回为空） |
| logistics_score | string | 物流评分（部分商品返回为空） |
| service_score | string | 服务评分（部分商品返回为空） |
| goods_id | string | 商品 id |
| cat_id | string | 类目 id |
| cat_id1 | string | 一级类目 id |
| cat_id2 | string | 二级类目 id |
| cat_id3 | string | 三级类目 id |
| cat_id4 | string | 四级类目 id |
| group_id | string | 成团 id(部分商品返回 0) |
| goods_state | int | 商品状态（0:非上架，1:出售中） |
| goods_name | string | 商品名字 |
| goods_desc | string | 商品描述 |
| thumb_url | string | 图片地址 |
| min_group_price | string | 成团最低价格(分) |
| max_group_price | string | 成团最高价格(分) |
| max_normal_price | string | 正常最高价格(分) |
| min_normal_price | string | 正常最低价格(分) |
| sales | string | sales |
| is_onsale | string | is_onsale |
| quantity | string | quantity |
| sku | object | sku |
| --specs | object | specs |
| ---spec_key | string | 关键字 |
| ---spec_value | string | 描述 |
| ---spec_key_id | string | 关键字 id |
| -- sku_id | string | sku_id |
| -- thumb_url | string | 图片地址 |
| -- quantity | string | 库存 |
| -- is_onsale | string | is_onsale |
| -- normal_price | string | 正常价格(分) |
| -- group_price | string | 组团价格(分) |
| property | object | property |
| --values | string | 描述 |
| --key | string | 关键字 |
| price_display | object | 券后价 |
| --prefix | string | 描述前缀 |
| --rmb | string | 符号 |
| --price | string | 券后价 |
| --suffix | string | 券后价后缀 |
| gallery | object | gallery（部分商品返回为空） |
| -- priority | string | priority （部分商品返回为空） |
| -- url | string | url（部分商品返回为空） |
| -- width | string | 宽（部分商品返回为空） |
| -- height | string | 长（部分商品返回为空） |
| -- type | string | 类型 （部分商品返回为空） |
| video_url | string | 视频路径(部分商品返回为空) |
| mall_promotion_new_cell | object | mall_promotion_new_cell |
| -cell_detail_list | array | cell_detail_list |
| --copy_writing | string | 优惠信息（部分商品返回为空） |
返回数据
{
"code": 0,
"msg": "成功",
"msec": 3571,
"time": 1667318261,
"data": {}
}
推送的数据
{
"mall_id": "809xxxx189",
"mall_name": "XXXXX",
"mall_logo": "http://t16img.yangkeduo.com/pdd_ims/mainObject/v1/pub_202209220400750c13074896aeac91b3e2ba844a.jpg",
"sales_tip": "全店已拼2.6万件",
"goods_num": "全店已拼2.6万件",
"goods_num_desc": "商品数量: 64",
"desc_score": 4.76,
"logistics_score": 4.76,
"service_score": 4.76,
"goods_id": "405454659034",
"cat_id": 16943,
"cat_id1": 16901,
"cat_id2": 16942,
"cat_id3": 16943,
"cat_id4": 0,
"group_id": 1111222,
"goods_state": 1,
"goods_name": "可爱小怪兽毛球钥匙扣网红ins毛绒玩偶书包挂饰送闺蜜生日礼物",
"goods_desc": "【品质险】可爱小怪兽毛球钥匙扣网红ins毛绒玩偶书包挂饰送闺蜜生日礼物",
"thumb_url": "https://img.pddpic.com/mms-material-img/2021-12-11/9149a253-58a5-45f8-b7bc-c57215b7cc87.jpeg.a.jpeg",
"min_group_price": 1500,
"max_group_price": 5220,
"max_normal_price": 8200,
"min_normal_price": 2500,
"sales": "已拼3712件",
"is_onsale": 1,
"quantity": 380,
"sku": [
[
{
"specs": [
{
"spec_key": "货号",
"spec_value": "炉灶厨具用 大号15片",
"spec_key_id": 8277
}
],
"sku_id": 1338594617388,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-02-06/1981a168-6a5d-4665-a667-287807b9317d.png",
"quantity": 26,
"is_onsale": 1,
"normal_price": 2500,
"group_price": 1930
}
],
[
{
"specs": [
{
"spec_key": "货号",
"spec_value": "炉灶厨具用 小号15片",
"spec_key_id": 8277
}
],
"sku_id": 1338594617301,
"thumb_url": "https://img.pddpic.com/mms-material-img/2022-09-29/277c8fe9-66ba-4944-92ef-f541b8217865.png.a.jpeg",
"quantity": 65,
"is_onsale": 1,
"normal_price": 2600,
"group_price": 1500
}
],
[
{
"specs": [
{
"spec_key": "货号",
"spec_value": "【超值】小号5片装*12包（60片）",
"spec_key_id": 8277
}
],
"sku_id": 1338594617302,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-02-06/5dd3001d-538d-4d59-a7bb-736d1f8fe997.png",
"quantity": 0,
"is_onsale": 1,
"normal_price": 8200,
"group_price": 5220
}
]
],
"property": [
{
"key": "品牌",
"values": [
"3M"
]
},
{
"key": "发货地",
"values": [
"浙江省"
]
},
{
"key": "材质",
"values": [
"尼龙"
]
},
{
"key": "款式",
"values": [
"单层"
]
},
{
"key": "使用对象",
"values": [
"灶台",
"碗",
"锅"
]
}
],
"price_display": [],
"gallery": [
{
"url": "https://video3.pddpic.com/i1/2022-11-08/865f30c2a72532baf150e5a25806afa1.mp4.f30.mp4",
"width": 1920,
"height": 1080,
"type": "video"
},
{
"url": "https://img.pddpic.com/open-gw/2022-08-24/8c7b336f-8eb5-4901-b61a-fac01940b0c1.jpeg",
"width": 790,
"height": 952,
"type": "image"
},
{
"url": "https://img.pddpic.com/open-gw/2022-08-24/0cc8fb01-dfd1-4e9f-b2b9-022d90175e88.jpeg",
"width": 790,
"height": 953,
"type": "image"
},
{
"url": "https://img.pddpic.com/open-gw/2022-08-24/bb6df39c-9d51-40bb-8262-01457a19e6db.jpeg",
"width": 790,
"height": 952,
"type": "image"
}
],
"video_url": "https://video3.pddpic.com/i1/2022-11-08/865f30c2a72532baf150e5a25806afa1.mp4.f30.mp4",
"mall_promotion_new_cell": {
"cellDetailList": [
{
"copy_writing": ""
}
]
}
}
响应代码
错误码 点击查看详情：查看