API文档中心

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

穿山甲-抖客商品搜索

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

本接口为穿山甲抖客CPS接口:

搜索抖客符合条件的商品,批量获取特定CPS商品列表信息。


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

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
title String 手机 搜索的商品关键词
page Int 1 商品第几页,从1开始
page_size Int 默认10 商品每页数量,最大20,最小1
first_cids String 20000或多个20000,20018 筛选商品一级类目,从商品类目接口可获得一级类目。可以指定一个分类,也可多个,用英文逗号相连
second_cids String 20131,20312 筛选商品二级类目, 从商品类目接口可获得二级类目。可以指定一个分类,也可多个,用英文逗号相连
third_cids String 20000或多个20000,20018 筛选商品三级类目,从商品类目接口可获得三级类目
price_min Int 1 最低价格,包含,单位分。
price_max Int 20 最高价格,不包含,单位分。应保证price_max>=price_min
sell_num_min Int   历史销量最小值
sell_num_max Int   历史销量最大值。应保证sell_num_max>sell_num_min
search_type Int   排序类型:0 默认排序;1历史销量排序;2价格排序;3佣金排序;4佣金比例排序。不填默认为0。
order_type Int   设置升降序:0 升序,1 降序。不填默认为0。若search_type为0,则此值无意义
cos_fee_min Int   最低分佣,单位分
cos_fee_max Int   最高分佣,单位分。应保证
cos_ratio_min Int   分佣比例百分比乘以100:1.1%,传1.1*100 = 110
cos_ratio_max Int   分佣比例百分比乘以100: 1.1%,传1.1*100 = 110
activity_id Int   获取活动商品。1返回超值购,0返回全量

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/douke/csj_search?vekey=xxx&title=手机 
【例子】搜索食品类
http://api.veapi.cn/douke/csj_search?vekey=xxx&first_cids=20018
使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/douke/csj_search?vekey=xxx&title=手机";

$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_search?vekey=xxx&title=手机";
        // 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_search?vekey=xxx&title=手机"

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

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

返回值(JSON)

参数名称 参数类型 示例值 描述
total Int   满足搜索条件的商品总数,如果超过2000,则只展示前2000
product_id Long   商品id
title String   商品名称
is_kol_product Bool   是否有达人特殊佣金
price Long   商品价格,单位分
in_stock Bool   有无库存
first_cid Long   商品一级类目
second_cid Long   商品二级类目
third_cid Long   商品三级类目
sales Int   商品历史销量
cover String   商品主图
detail_url String   商品链接
shop_id Long   商铺id
shop_name String   商铺名称
coupon_price Long   券后价格,单位分(0或者没传则为原价)
cos_ratio Int   分佣比例,百分比乘以 100,比如 1% 返回 1*100 = 100
cos_fee Int   佣金金额,单位分
activity_id Int   获取活动商品。1: 返回超值购商品;0:返回全量商品
ext String   一个加密字段,需要在转链接口当中回传
post_free Bool   是否包邮
limit_min_sale Bool   是否多件起购

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "查询成功!", "total": 2000, "data": [ { "product_id": "3590471656293989864", "title": "【实发50包买30包+送20包】Q弹手磨嫩豆干五香味办公休闲即食小零食", "is_kol_product": false, "price": 999, "first_cid": 20018, "second_cid": 20355, "third_cid": 23384, "in_stock": true, "sales": 100000, "cover": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/cUdqSCLw_m_d1c41d3d1610356fb01f3f81b597a3f0_sx_615278_www800-800", "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3590471656293989864&origin_type=open_platform", "shop_id": 57923187, "shop_name": "金莱食品企业店", "coupon_price": 0, "cos_ratio": 2600, "cos_fee": 260, "ext": "req_id=D862E442-F412-445D-9D27-D503D4F13AEC&product_id=3590471656293989864", "activity_id": 0, "post_free": true, "limit_min_sale": false } ], "logid": "2024033117182931CE9C9ED5F50F590F84", "request_id": "9ddpmqV" }

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部