接口使用场景等说明:本接口为穿山甲抖客CPS接口:
搜索抖客符合条件的商品,批量获取特定CPS商品列表信息。
【特别提示】由于穿山甲和抖客有限制频率,因此穿山甲接口只接收有订单转化浓度5%以上的用户订单,纯采集请不要调用,否则会冻结帐户。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/douke/csj_search | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
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返回全量 |
GET/POST http://api.veapi.cn/douke/csj_search?vekey=xxx&title=手机【例子】搜索食品类
http://api.veapi.cn/douke/csj_search?vekey=xxx&first_cids=20018
$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; //返回值
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); } }
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
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
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" }