大淘客,让选品更简单! |

{{item.type_name}}:

API 市场 / 9.9包邮精选
 

应用场景:
用于搭建应用内的营销专区,或在社群内进行分发推广
接口说明:
该接口返回的商品价格区间在1-19.9范围内。低价且包邮,高转化率,可持续提升用户活跃度
使用人数: 7000+
9.9包邮精选 接口测试 建议使用通用GET方法调用
  • 接口说明
  • 更新日志
  • 接口版本号:v3.0.0
  • 接口版本号:v2.0.0
  • 接口版本号:v1.2.2

请求地址:https://openapi.dataoke.com/api/goods/nine/op-goods-list 复制

请求方式:GET

公共参数:
请求参数:

注:请求参数须区分大小写

返回数据:
调用示例:
String url = "https://openapi.dataoke.com/api/goods/nine/op-goods-list";
String appKey = "xxx";
String appSecret = "xxx";
TreeMap<String, String> paraMap = new TreeMap<>();
paraMap.put("version", "v2.0.0");
paraMap.put("appKey", appKey);
paraMap.put("pageId", "1");
paraMap.put("pageSize", "20");
paraMap.put("nineCid", "1");
String data = ApiClient.sendReq(url, appSecret, paraMap);

SDK调用示例
String appKey = "xxx";
String appSecret = "xxx";
DtkApiClient client = DtkApiClient.getInstance(appKey,appSecret);
DtkOpGoodsListRequest request = new DtkOpGoodsListRequest();
request.setPageSize(20);
request.setPageId("1");
request.setNineCid("1");
DtkApiResponse < DtkPageResponse < DtkOpGoodsListResponse >> execute = client.execute(request);
返回示例:
status: 200,
data: {
requestId: "1309d58ddfeb1e4787eb6cef9dddeda3",
time: 1656575026685,
code: 0,
msg: "成功",
data: {
list: [
{
id: 38580967,
goodsId: "644363113283",
title: "400张抽纸整箱批大包餐巾纸家用实惠装卫生面巾纸抽婴儿纸巾漫花",
dtitle: "【十万库存】400张*3大包漫花抽纸",
originalPrice: 11.1,
actualPrice: 5.1,
shopType: 1,
goldSellers: 0,
monthSales: 333849,
twoHoursSales: 682,
dailySales: 2249,
commissionType: 3,
desc: "漫花原生木浆抽纸,家用擦拭更全面湿水强韧不易烂,干湿两用,原生木浆,健康环保,柔韧亲肤!",
couponReceiveNum: 13385,
couponLink: "https://uland.taobao.com/quan/detail?sellerId=2930255252&activityId=21e3a4b16d6d4a979b3b843cf76089d5",
couponEndTime: "2022-06-30 23:59:59",
couponStartTime: "2022-06-23 00:00:00",
couponPrice: 6,
couponConditions: "11",
couponId: "21e3a4b16d6d4a979b3b843cf76089d5",
activityType: 1,
createTime: "2022-06-23 10:40:13",
mainPic: "https://img.alicdn.com/imgextra/i4/2207363067727/O1CN01FOrZ5g26x16IoKsYa_!!2207363067727.jpg",
marketingMainPic: "https://sr.ffquan.cn/dtk_www/20220227/c8dkopnuhk3n1hsu0uj00.jpg",
sellerId: "2930255252",
brandWenan: "",
cid: 4,
tbcid: 50012478,
discounts: 0.46,
commissionRate: 2,
couponTotalNum: 100000,
haitao: 0,
activityStartTime: "",
activityEndTime: "",
shopName: "漫花旗舰店",
shopLevel: 20,
descScore: 4.9,
brand: 1,
brandId: 47465441,
brandName: "漫花",
hotPush: 0,
teamName: "梦想dream团队",
itemLink: "https://detail.tmall.com/item.htm?id=644363113283",
tchaoshi: 0,
detailPic: "",
dsrScore: 4.77,
dsrPercent: -0.7,
shipScore: 4.81,
shipPercent: -0.82,
serviceScore: 4.81,
servicePercent: -0.66,
subcid: [
86341
],
nineCid: 2,
quanMLink: 0,
hzQuanOver: 0,
yunfeixian: 0,
estimateAmount: 0,
freeshipRemoteDistrict: 1,
video: "",
specialText: [],
marketGroup: [
-1
],
lowest: 0
}
],
totalNum: 5879,
pageId: "3"
}
},
msg: "请求成功"
错误码列表:

请求地址:https://openapi.dataoke.com/api/goods/nine/op-goods-list 复制

请求方式:GET

公共参数:
请求参数:

注:请求参数须区分大小写

返回数据:
调用示例:
String url = "https://openapi.dataoke.com/api/goods/nine/op-goods-list";
String appKey = "xxx";
String appSecret = "xxx";
TreeMap<String, String> paraMap = new TreeMap<>();
paraMap.put("version", "v2.0.0");
paraMap.put("appKey", appKey);
paraMap.put("pageId", "1");
paraMap.put("pageSize", "20");
paraMap.put("nineCid", "1");
String data = ApiClient.sendReq(url, appSecret, paraMap);

SDK调用示例
String appKey = "xxx";
String appSecret = "xxx";
DtkApiClient client = DtkApiClient.getInstance(appKey,appSecret);
DtkOpGoodsListRequest request = new DtkOpGoodsListRequest();
request.setPageSize(20);
request.setPageId("1");
request.setNineCid("1");
DtkApiResponse < DtkPageResponse < DtkOpGoodsListResponse >> execute = client.execute(request);
返回示例:
{
	"status": 200,
	"data": {
		"time": 1588993197321,
		"code": 0,
		"msg": "成功",
		"data": {
			"list": [{
				"id": 26212927,
				"goodsId": "566274514615",
				"title": "日式室内家用软底拖鞋浴室洗澡防滑情侣外穿凉拖鞋女夏季男家居鞋",
				"dtitle": "【百万好评】居家浴室防滑软底拖鞋",
				"originalPrice": 5.9,
				"actualPrice": 4.9,
				"shopType": 0,
				"goldSellers": 1,
				"monthSales": 800000,
				"twoHoursSales": 0,
				"dailySales": 0,
				"commissionType": 3,
				"desc": "100万好评!全家都能穿!!只需4.9元!!男女款都贼靓,看的我心里忒喜欢,赶紧往家抱两双!超市售价至少15.9元,全家的拖鞋一次采购齐全!",
				"couponReceiveNum": 2400,
				"couponLink": "https://uland.taobao.com/quan/detail?sellerId=849090736&activityId=fa0aef34aa2c44779745456d98b2ba48",
				"couponEndTime": "2020-05-10 23:59:59",
				"couponStartTime": "2020-05-07 00:00:00",
				"couponPrice": 1,
				"couponConditions": "5",
				"activityType": 1,
				"createTime": "2020-05-09 10:31:21",
				"mainPic": "https://img.alicdn.com/imgextra/i4/2206368566482/O1CN01QSzfZ31xknssZlNH8_!!2206368566482.jpg",
				"marketingMainPic": "https://sr.ffquan.cn/dtk_user_fd/20200226/bpb3uusq57brvt58slp00.jpg",
				"sellerId": "849090736",
				"cid": 4,
				"discounts": 0.83,
				"commissionRate": 20,
				"couponTotalNum": 82400,
				"haitao": 0,
				"activityStartTime": "",
				"activityEndTime": "",
				"shopName": "集美日用家居商城",
				"shopLevel": 20,
				"descScore": 4.7,
				"brand": 0,
				"brandId": 3579236,
				"brandName": "",
				"hotPush": 0,
				"teamName": "渔夫联盟",
				"itemLink": "https://detail.tmall.com/item.htm?id=566274514615",
				"tchaoshi": 0,
				"detailPics": "",
				"dsrScore": 4.7,
				"dsrPercent": -0.53,
				"shipScore": 4.8,
				"shipPercent": 0.4,
				"serviceScore": 4.8,
				"servicePercent": 0.37,
				"subcid": [],
				"nineCid": 1,
				"quanMLink": 0,
				"hzQuanOver": 0,
				"yunfeixian": 0,
				"estimateAmount": -1,
				"freeshipRemoteDistrict": 0,
				"tbcid": 50025847
			}],
			"totalNum": 8447,
			"pageId": "54993ddcec9fbf0d"
		}
	},
	"msg": "请求成功"
}
常见错误码:
{
    "msg":"服务器错误",
    "code":-1,
    "time":1554365022200
}
错误码列表:

请求地址:https://openapi.dataoke.com/api/goods/nine/op-goods-list 复制

请求方式:GET

公共参数:
请求参数:

注:请求参数须区分大小写

返回数据:
调用示例:
String url = "https://openapi.dataoke.com/api/goods/nine/op-goods-list";
String appKey = "xxx";
String appSecret = "xxx";
TreeMap<String, String> paraMap = new TreeMap<>();
paraMap.put("version", "v1.2.2");
paraMap.put("appKey", appKey);
paraMap.put("pageId", "1");
paraMap.put("pageSize", "20");
paraMap.put("nineCid", "1");
String data = ApiClient.sendReq(url, appSecret, paraMap);
 //9.9包邮精选
    $data = [
        'appKey' => "xxxxxxxxxxxx",
        'version' => "v1.0.0",
        ...
    ];
    $host = "https://openapi.dataoke.com/api/goods/nine/op-goods-list";
    $url = $host . '?' . http_build_query($data);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_TIMEOUT, $this->timeout);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    $output = curl_exec($ch);
    $a = curl_error($ch);
    if(!empty($a)){
        return json_encode(array('code'=>10003, 'msg'=>$a));
    }
    curl_close($ch);
    return $output;

    SDK调用示例
    $client = new GetNineOpGoodsList();
    $client->setAppKey("xxxxxxxxx");
    $client->setAppSecret("xxxxxxxxxxxxxxxxxxxxxxxxx");
    $client->setVersion("v1.0.0");

    $res = $client->setParams([])->request();

package main

import (
	"fmt"
	"gitee.com/dtk-developer/openapi-sdk-go/sdk"
)

func main() {
	// 1.初始化所需要的参数appKey, appSecret, version
	var (
		appKey = "xxxxxxxxxx"
		appSecret = "xxxxxxxxxx"
		version = "v1.3.1"
	)

	// 2.初始化开放平台api的客户端句柄
	oa := &sdk.OpenApi{}
	oa.AppKey = appKey
	oa.AppSecret = appSecret
	oa.Version = version
	client :=  oa.GetClient()

	// 3.准备请求参数
	params := map[string]string {
		"pageSize": "1",
	}

	// 4.业务请求,示例使用9.9包邮精选和淘系万能解析接口,其它开放接口使用方法相同
	resp, err := client.OpGoodsList(params)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp)

	// 复用client句柄
	params = map[string]string {
		// 指定接口版本
		"version": "v1.0.0",
		"content": "1👈¥fym8XiJU9Oi¥ https://s.click.taobao.com/Ys3TNlu  包邮 漫花抽纸10包4层加厚280张/包纸巾卫生纸家用实惠装面巾纸",
	}
	resp, err = client.ParseContent(params)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp)
}
返回示例:
{
	"status": 200,
	"data": {
		"time": 1588993197321,
		"code": 0,
		"msg": "成功",
		"data": {
			"list": [{
				"id": 26212927,
				"goodsId": "566274514615",
				"title": "日式室内家用软底拖鞋浴室洗澡防滑情侣外穿凉拖鞋女夏季男家居鞋",
				"dtitle": "【百万好评】居家浴室防滑软底拖鞋",
				"originalPrice": 5.9,
				"actualPrice": 4.9,
				"shopType": 0,
				"goldSellers": 1,
				"monthSales": 800000,
				"twoHoursSales": 0,
				"dailySales": 0,
				"commissionType": 3,
				"desc": "100万好评!全家都能穿!!只需4.9元!!男女款都贼靓,看的我心里忒喜欢,赶紧往家抱两双!超市售价至少15.9元,全家的拖鞋一次采购齐全!",
				"couponReceiveNum": 2400,
				"couponLink": "https://uland.taobao.com/quan/detail?sellerId=849090736&activityId=fa0aef34aa2c44779745456d98b2ba48",
				"couponEndTime": "2020-05-10 23:59:59",
				"couponStartTime": "2020-05-07 00:00:00",
				"couponPrice": 1,
				"couponConditions": "5",
				"activityType": 1,
				"createTime": "2020-05-09 10:31:21",
				"mainPic": "https://img.alicdn.com/imgextra/i4/2206368566482/O1CN01QSzfZ31xknssZlNH8_!!2206368566482.jpg",
				"marketingMainPic": "https://sr.ffquan.cn/dtk_user_fd/20200226/bpb3uusq57brvt58slp00.jpg",
				"sellerId": "849090736",
				"cid": 4,
				"discounts": 0.83,
				"commissionRate": 20,
				"couponTotalNum": 82400,
				"haitao": 0,
				"activityStartTime": "",
				"activityEndTime": "",
				"shopName": "集美日用家居商城",
				"shopLevel": 20,
				"descScore": 4.7,
				"brand": 0,
				"brandId": 3579236,
				"brandName": "",
				"hotPush": 0,
				"teamName": "渔夫联盟",
				"itemLink": "https://detail.tmall.com/item.htm?id=566274514615",
				"tchaoshi": 0,
				"detailPics": "",
				"dsrScore": 4.7,
				"dsrPercent": -0.53,
				"shipScore": 4.8,
				"shipPercent": 0.4,
				"serviceScore": 4.8,
				"servicePercent": 0.37,
				"subcid": [],
				"nineCid": 1,
				"quanMLink": 0,
				"hzQuanOver": 0,
				"yunfeixian": 0,
				"estimateAmount": -1,
				"freeshipRemoteDistrict": 0,
				"tbcid": 50025847
			}],
			"totalNum": 8447,
			"pageId": "54993ddcec9fbf0d"
		}
	},
	"msg": "请求成功"
}
常见错误码:
{
    "msg":"服务器错误",
    "code":-1,
    "time":1554365022200
}
错误码列表: