API文档中心

热门接口：产品ID找同款全量维权查询万能转链字符串ID转换 （有API需求可联系本站）

运营频道商品查询API

调用权限：核心接口会员卡调用
 接口测试 
接口使用场景等说明：

运营频道商品查询,包括：百亿补贴、千万神券、招商礼金商品、选爆品-官方直推爆款、以及今日销量榜,相似商品推荐,猜你喜欢(和进宝网站精选一致),实时热销榜,实时收益榜等等。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/pdd/pdd_recommend 暂无

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
activity_tags Integer[] 否   活动商品标记数组，例：[4,7]，4-秒杀，7-百亿补贴，10851-千万补贴，11879-千万神券，10913-招商礼金商品，31-品牌黑标，10564-精选爆品-官方直推爆款，10584-精选爆品-团长推荐，24-品牌高佣，其他的值请忽略
cat_id Long 否   猜你喜欢场景的商品类目，20100-百货，20200-母婴，20300-食品，20400-女装，20500-电器，20600-鞋包，20700-内衣，20800-美妆，20900-男装，21000-水果，21100-家纺，21200-文具,21300-运动,21400-虚拟,21500-汽车,21600-家装,21700-家具,21800-医药;
channel_type Integer 否   进宝频道推广商品: 1-今日销量榜,3-相似商品推荐,4-猜你喜欢(和进宝网站精选一致),5-实时热销榜,6-实时收益榜。默认值5
custom_parameters String 否   自定义参数，必须是与p_id备案关联过（参备案接口），为链接打上自定义标签；参数最长限制64个字节；格式：{"uid":"11","sid":"22"}，如果您只传Uid,那么也可以直接用字符串表示，如custom_parameters=11。其中 uid 必选，用户唯一标识，每个用户仅且对应一个标识； sid可选，表示上下文信息标识，例如sessionId等。该json字符串中也可以加入其他自定义的key/value对。（如果使用GET请求，请使用URLEncode处理参数）
force_auth_duo_id Boolean 否   是否使用工具商专属推广计划，默认为false
goods_img_type Integer 否   商品主图类型：1-场景图，2-白底图，默认为0
goods_sign_list String[] 否   商品goodsSign列表，相似商品推荐场景时必传，仅取数组的第一位，例如：c9r2omogKFFAc7WBwvbZU1ikIb16_J3CTa8HNN,E9H26YptkExEb5jlwfnb3D6TL_PIjzR3_JQiF3JSUU7多个goods_sign用逗号相连。
limit Integer 否 20 一页请求数量；默认值：20
list_id String 否   翻页时建议填写前页返回的list_id值
offset Integer 否 0 从多少位置开始请求；默认值：0
pid String 否   推广位id

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/pdd/pdd_recommend?vekey=xxx
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/pdd/pdd_recommend?vekey=xxx";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流，不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool，以hutool为例：

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/pdd/pdd_recommend?vekey=xxx";
        // JDK 8u111版本后，若目标页面为HTTPS协议，请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时，毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests，支持访问http,https网页：

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/pdd/pdd_recommend?vekey=xxx"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值（JSON）

参数名称 参数类型 示例值 描述
activity_promotion_rate Long   活动佣金比例，千分比（特定活动期间的佣金比例）
activity_tags Integer[]   商品活动标记数组，例：[4,7]，4-秒杀,7-百亿补贴等
brand_name String   商品品牌词信息，如“苹果”、“阿迪达斯”、“李宁”等
cash_gift_amount Long   全局礼金金额，单位分
cat_id String   商品类目id
cat_ids Long[]   商品一~四级类目ID列表
coupon_discount Long   优惠券面额,单位为分
coupon_end_time Long   优惠券失效时间,UNIX时间戳
coupon_min_order_amount Long   优惠券门槛价格,单位为分
coupon_price Long   优惠券金额
coupon_remain_quantity Long   优惠券剩余数量
coupon_start_time Long   优惠券生效时间,UNIX时间戳
coupon_total_quantity Long   优惠券总数量
create_at Long   创建时间
desc_txt String   描述分
extra_coupon_amount Long   额外优惠券，单位为分
goods_desc String   商品描述
goods_image_url String   商品主图
goods_labels Integer[]   商品特殊标签列表。例:[1]，1-APP专享
goods_name String   商品名称
goods_rate Long   商品等级
goods_sign String   商品goodsSign，支持通过goodsSign查询商品。
goods_thumbnail_url String   商品缩略图
goods_type Integer   商品类型
has_coupon Boolean   商品是否带券,true-带券,false-不带券
has_material Boolean   商品是否有素材(图文、视频)
lgst_txt String   物流分
mall_id Long   商家id
mall_name String   店铺名称
market_fee Long   市场服务费
merchant_type String   商家类型
min_group_price Long   最小成团价格，单位分
min_normal_price Long   最小单买价格，单位分
opt_id String   商品标签类目ID
opt_ids Long[]   商品一~四级标签类目ID列表
opt_name String   商品标签名
predict_promotion_rate Long   比价行为预判定佣金，需要用户备案
promotion_rate Long   佣金比例,千分比
qr_code_image_url String   二维码主图
realtime_sales_tip String   商品近1小时在多多进宝的实时销量（仅实时热销榜提供）
sales_tip String   销售量
search_id String   搜索id，建议生成推广链接时候填写，提高收益。
serv_txt String   服务分
share_desc String   分享描述
share_rate Integer   招商分成服务费比例，千分比
subsidy_amount Integer   优势渠道专属商品补贴金额，单位为分。针对优质渠道的补贴活动，指定优势渠道可通过推广该商品获取相应补贴。补贴活动入口：[进宝网站-官方活动]
subsidy_duo_amount_ten_million Integer   官方活动给渠道的收入补贴金额，不允许直接给下级代理展示，单位为分
unified_tags String[]   优惠标签列表，包括："X元券","比全网低X元","服务费","精选素材","近30天低价","同款低价","同款好评","同款热销","旗舰店","一降到底","招商优选","商家优选","好价再降X元","全站销量XX","实时热销榜第X名","实时好评榜第X名","额外补X元"等
list_id String   翻页时必填前页返回的list_id值
search_id String   搜索id，建议生成推广链接时候填写，提高收益。
total Integer   总商品数

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "运营频道商品查询成功", "data": { "total": "2878", "list": [ { "category_name": "食品", "coupon_remain_quantity": "16000", "extra_coupon_amount": "3000", "promotion_rate": "126", "cat_ids": [ 6536, 6580, 6582 ], "coupon_min_order_amount": "3000", "category_id": "1", "mall_id": "742740777", "mall_name": "认养食品旗舰店", "coupon_total_quantity": "20000", "market_fee": "1798", "merchant_type": "3", "lgst_txt": "高", "goods_name": "【官方直营】认养吃甘蔗的水牛奶整箱200g*10盒*3箱早餐纯奶【7天内发货】", "sales_tip": "3.4万", "has_material": false, "goods_id": "325882965720", "predict_promotion_rate": "180", "desc_txt": "高", "goods_desc": "【官方直营】认养吃甘蔗的水牛奶整箱200g*10盒*3箱早餐纯奶【7天内发货】", "opt_name": "食品", "realtime_sales_tip": "2.9万", "share_rate": "0", "goods_thumbnail_url": "https://img.pddpic.com/gaudit-image/2022-11-21/022e9c5300eaccddf052601271f58718.jpeg", "opt_ids": [ 1, 22945, 2402, 10724, 11814 ], "opt_id": "1", "search_id": "55989920-2922-41c2-b144-086aa4e139bb", "goods_image_url": "https://img.pddpic.com/mms-material-img/2022-11-10/657569a2-4ef9-4719-8abb-aec5f05fafc0.jpeg", "activity_tags": [ 10834, 12010, 12351, 12352 ], "has_coupon": true, "min_normal_price": "13990", "serv_txt": "高", "unified_tags": [ "30元福利券", "坏了包赔", "品质险", null ], "coupon_start_time": "1671465600", "min_group_price": "12990", "coupon_discount": "3000", "goods_sign": "E9H26YptkExEb5jlwfnb3D6TL_PIjzR3_JQiF3JSUU7", "coupon_end_time": "1687017599" } ], "request_id": "16715954975584188", "search_id": "55989920-2922-41c2-b144-086aa4e139bb" }, "request_id": "RYezPru" }

错误码

如果error不为0时，请点此查看错误码表格

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部