API文档中心

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

穿山甲CPS接口:直播间列表和查询指定直播间

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

本接口功能:

1、可以查询指定的直播间及带货商品信息;

2、批量获取直播间列表及带货商品信息。



【特别提示】由于穿山甲和抖客有限制频率,因此穿山甲接口只接收有订单转化浓度5%以上的用户订单,纯采集请不要调用,否则会冻结帐户。

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
page Int 1 分页index,从1开始
page_size Int 10 分页size,范围0,100; 默认10
sort_by Int 1 排序字段: 1-综合;2-销量;3-佣金率;4-粉丝数。不填默认为1
sort_type Int 0 排序方式:0-降序;1-升序。不填默认为0。若sort_by为1, 则此字段无意义
status Int 1 直播间状态筛选:0-在播和不在播,1-在播,2-不在播。默认为1,代表只出在播直播间
author_info String xxx直播间 达人昵称/账号
need_products Int 0 是否需要返回商品:1-返回,0-不返回。默认为0,代表返回商品信息

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/douke/csj_livesearch?vekey=xxx&page=1 
【例子】查询指定直播间的信息
http://api.veapi.cn/douke/csj_livesearch?vekey=xxx&author_info=迪丝嫚苓服饰官方账号(请urlencode)
使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/douke/csj_livesearch?vekey=xxx&page=1";

$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/douke/csj_livesearch?vekey=xxx&page=1";
        // 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/douke/csj_livesearch?vekey=xxx&page=1"

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

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

返回值(JSON)

参数名称 参数类型 示例值 描述
total Int 2 符合条件的最大直播间数量
author_openid String 1@#aS9OOutIFFRrw 直播间主播openid
author_buyin_id String 6941237272159289614 直播间主播百应id
author_name String 迪丝嫚苓服饰官方账号 昵称
author_pic String   头像
author_level Int 6 达人等级
product_category Array   商品类别
average_gmv String 50万-100万 场均gmv
fans_num Int 1021007 粉丝数量
average_commission_rate String 1.00 平均佣金率
room_id String 73566551 直播间id
gender String female 性别 male/ female/ 未知
ext String 8d6a0710-f004-11ee-8d96-2e1112e8e6f5 内部生成的加密字段。直播间转链请求的live_ext应填此字段
online_num Int 2807 查询时刻在线人数
create_time Int 1711943730 开播时间戳
products Object   直播间挂车的商品信息。
 └─ product_id Long 123456 商品id
 └─ title String 测试商品 商品名称
 └─ price Long 100 商品价格,单位分
 └─ in_stock Bool true 是否上架, 保证一定上架
 └─ first_cid Long 1 商品一级类目
 └─ first_cname String 男装 商品一级类目名称
 └─ second_cid Long 2 商品二级类目
 └─ second_cname String T恤 商品二级类目名称
 └─ third_cid Long 3 商品三级类目
 └─ third_cname String 女装 商品三级类目名称
 └─ sales Int 100 商品历史销量
 └─ cover String https://...jpeg 商品主图
 └─ detail_url String https://.. 商品链接
 └─ coupon_price Long 29900 直播间展示的最终价格,单位分(0或者没传则为原价)
 └─ shop_id Long 127466081 商铺id
 └─ shop_name String 彩华专卖店 商铺名称
 └─ cos_ratio Int 0 新客分佣比例,百分比乘以 100,比如 1% 返回 1*100 = 100。多数用户通常为新人。新客与老客的区分。如果用户在第一次转链跳转到直播间之前一定时间内就已经关注了该直播间(包含一定时间内关注后又取关),那么该用户为老客,否则为新客。参见抖客直播间推广结算规则
 └─ cos_fee Int 0 新客佣金金额,单位分
 └─ old_fans_cos_ratio Int 1 老客分佣比例,百分比乘以 100,比如 1% 返回 1*100 = 100。
 └─ old_fans_cos_fee Int 1 老客佣金金额,单位分
 └─ is_explaining Bool true 是否正在讲解
 └─ has_given_product Bool false 是否有赠品
 └─ available_coupons Object   优惠券信息列表。coupon_price已扣减了优惠券。此列表不包含用户个性化券
    └─ coupon_type Int 1 优惠券类型:1 平台券;2 店铺券;3 达人券。
    └─ type_desc String 平台券 券类型描述
    └─ discount_desc String 满50减10券 券描述
 └─ lottery_activity_info Object   福袋活动信息。关于福袋活动,可参考福袋活动功能上线通知 。若想用福袋活动引流,需要注意福袋活动的起始和结束时间,保证福袋活动是正在进行的。
    └─ lottery_activity_id Int 7352775932007465225 福袋活动id
    └─ lottery_product_start_time Int 1711952079 福袋活动起始时间戳(北京时间)
    └─ lottery_product_end_time Int 1711952079 福袋活动结束/开奖时间戳(北京时间)
lottery_products Object   直播间挂车的福袋商品活动信息。若没有就不返回。会返回当前直播间开播以来开展过的所有福袋活动(包含已过期和正在进行)。其它字段信息参考products字段

返回示例

【提示】推广链接或口令有时效性,示例中链接与口令为创建文档时生成,仅用于展示返回结果,有可能已失效。

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部