欢迎使用拼多多API接口（item_search-根据关键词取商品列表）
你好！ 这是你使用我们的拼多多API接口获取商品详细接口说明
开通账号联系：Q1140666069 V13879028982
请求参数：
请求参数：q=女&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=
参数说明：q:关键词, sort:排序[bid,_bid,_sale,sale] (bid:商品价格,sale:销量,加_前缀为从大到小排序) 响应参数：
Version: Date:
请求示例：
Curl：
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size="
PHP:
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
PHPsdk：
<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");
$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时，是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;
$api_data = $obapi->exec(
array(
"api_type" =>"pinduoduo",
"api_name" =>"item_search",
"api_params"=>array (
'q' => '女装',
'start_price' => '0',
'end_price' => '0',
'page' => '1',
'cat' => '0',
'discount_only' => '',
'sort' => '',
'page_size' => '',
)
)
);
var_dump($api_data);
?>
JAVA：
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;
public class Example {
private static String readAll(Reader rd) throws IOException {
StringBuilder sb = new StringBuilder();
int cp;
while ((cp = rd.read()) != -1) {
sb.append((char) cp);
}
return sb.toString();
}
public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter out = new PrintWriter(conn.getOutputStream());
out.print(body);
out.flush();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static void main(String[] args) throws IOException, JSONException {
// 请求示例 url 默认请求参数已经URL编码处理
String url = "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
C#：
//using System.Net.Security;
//using System.Security.Cryptography.X509Certificates;
private const String method = "GET";
static void Main(string[] args)
{
String bodys = "";
// 请求示例 url 默认请求参数已经做URL编码
String url = "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=";
HttpWebRequest httpRequest = null;
HttpWebResponse httpResponse = null;
if (url.Contains("https://"))
{
ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
}
else
{
httpRequest = (HttpWebRequest)WebRequest.Create(url);
}
httpRequest.Method = method;
if (0 < bodys.Length)
{
byte[] data = Encoding.UTF8.GetBytes(bodys);
using (Stream stream = httpRequest.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
}
try
{
httpResponse = (HttpWebResponse)httpRequest.GetResponse();
}
catch (WebException ex)
{
httpResponse = (HttpWebResponse)ex.Response;
}
Console.WriteLine(httpResponse.StatusCode);
Console.WriteLine(httpResponse.Method);
Console.WriteLine(httpResponse.Headers);
Stream st = httpResponse.GetResponseStream();
StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
Console.WriteLine(reader.ReadToEnd());
Console.WriteLine("\n");
}
public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
{
return true;
}
Python：
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
响应示例：
{
"items": {
"keyword": "女装",
"page": "1",
"real_total_results": 300,
"total_results": 300,
"list_count": 20,
"item": [
{
"title": "【三件套】新款秋冬季女装套装裙皮草短外套搭打底衫毛衣配半身裙",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-06-05/b15035efb5913e1e8b647422010522c1.jpeg",
"price": 134,
"promotion_price": 134,
"sales": 18000,
"num_iid": 43992967514,
"sample_id": "",
"seller_nick": "果果家气质女装",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=43992967514"
},
{
"title": "【2件套】套装秋冬新款仿獭兔毛钉珠皮草毛毛短外套加厚大衣女装",
"pic_url": "https://omsproductionimg.yangkeduo.com/images/2018-06-06/463c0e2a5580ba3266846e41fe3e444a.jpeg",
"price": 169,
"promotion_price": 169,
"sales": 40000,
"num_iid": 1620002566,
"sample_id": "",
"seller_nick": "果果家气质女装",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=1620002566"
},
{
"title": "仿水貂毛皮草外套女冬短款韩版修身显瘦百搭毛绒加厚新娘披肩礼服",
"pic_url": "https://omsproductionimg.yangkeduo.com/images/2018-01-03/1f3866498a067e00e39a38fe144ec5f3.jpeg",
"price": 88,
"promotion_price": 88,
"sales": 218,
"num_iid": 410684172,
"sample_id": "",
"seller_nick": "乐荣源淘衣坊",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=410684172"
},
{
"title": "仿貂毛大衣女秋冬加厚仿狐狸毛领皮草外套女长款仿水貂绒外套显瘦",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-06-28/f6ea981d0cfe5dc096af33457328c819.jpeg",
"price": 298,
"promotion_price": 298,
"sales": 42000,
"num_iid": 144592781204,
"sample_id": "",
"seller_nick": "珞摩服装旗舰店",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=144592781204"
},
{
"title": "三件套裙套装新款秋冬女韩版钉珠皮草短外套搭打底衫毛衣配半身裙",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-24/1fd6806d8de95adce0196294765079f1.jpeg",
"price": 269,
"promotion_price": 269,
"sales": 2525,
"num_iid": 2748395485,
"sample_id": "",
"seller_nick": "蹦蹦服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=2748395485"
},
{
"title": "三件套2020新款秋冬季皮草裙套装女短外套搭打底衫毛衣配半身裙子",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-10-22/97440d8034ad1a319e71cd501aa6d9bc.jpeg",
"price": 239,
"promotion_price": 239,
"sales": 119,
"num_iid": 4544773413,
"sample_id": "",
"seller_nick": "自然之美服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=4544773413"
},
{
"title": "三件套裙套装2020新款秋冬季皮草女短外套搭打底衫毛衣配半身裙子",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-10-23/0e5aa1adb63ce256664d4274d0ff0fa1.jpeg",
"price": 188,
"promotion_price": 188,
"sales": 1587,
"num_iid": 3540607180,
"sample_id": "",
"seller_nick": "自然之美服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=3540607180"
},
{
"title": "2020秋冬装毛毛钉珠仿皮草外套新款韩版修身圆领学生上衣【单件】",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2021-01-28/503c10fe716873ceaccf103c30881908.jpeg",
"price": 79,
"promotion_price": 79,
"sales": 1157,
"num_iid": 35225305026,
"sample_id": "",
"seller_nick": "夏衣伊人",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=35225305026"
},
{
"title": "两件套秋冬新款气质钉珠仿皮草外套配刺绣半身裙保暖加厚上衣女装",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-17/5d57e2f0df37b13f5472d03175246d28.jpeg",
"price": 139,
"promotion_price": 139,
"sales": 2616,
"num_iid": 369492636,
"sample_id": "",
"seller_nick": "蹦蹦服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=369492636"
},
{
"title": "2020秋冬装毛毛钉珠仿皮草外套新款韩版修身圆领淑女上衣【单件】",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2021-01-28/b208cc827f66c0b5eac9d40762178d28.jpeg",
"price": 88,
"promotion_price": 88,
"sales": 232,
"num_iid": 3540686169,
"sample_id": "",
"seller_nick": "自然之美服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=3540686169"
},
{
"title": "2018秋冬装毛毛钉珠仿皮草外套新款韩版修身圆领学生上衣【单件】",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2018-09-24/22c7a21f49c4ddfe228acc5d15c1bbe0.jpeg",
"price": 138,
"promotion_price": 138,
"sales": 210,
"num_iid": 3062555797,
"sample_id": "",
"seller_nick": "果果家气质女装",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=3062555797"
},
{
"title": "三件套网红裙套装新款秋冬女钉珠皮草搭打底衫毛衣配半身裙短外套",
"pic_url": "https://t00img.yangkeduo.com/goods/images/images/2019-09-10/403fae6f0c281b247e305559cff71cca.jpeg",
"price": 269,
"promotion_price": 269,
"sales": 144,
"num_iid": 35224334938,
"sample_id": "",
"seller_nick": "夏衣伊人",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=35224334938"
},
{
"title": "单件外套短款女秋冬新品海宁仿皮草韩版宽松显瘦百搭钉珠圆领上衣",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-24/55a25e3b612a5ba2655046718a20c0ab.jpeg",
"price": 88,
"promotion_price": 88,
"sales": 2314,
"num_iid": 368488818,
"sample_id": "",
"seller_nick": "蹦蹦服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=368488818"
},
{
"title": "粗花呢套装女2020秋冬新款小香风时尚洋气小西装包臀裙休身显瘦潮",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-07-16/84ffe1375b1d3b1a6455b9c387cd495b.jpeg",
"price": 139,
"promotion_price": 139,
"sales": 216,
"num_iid": 150435444702,
"sample_id": "",
"seller_nick": "小清新职装",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=150435444702"
},
{
"title": "啄木鸟加厚羽绒棉衣女冬季新款胖mm宽松显瘦棉服外套女士大码棉袄",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-11-24/a8798a380a8e64503a3b6f2df3cdc5e6.jpeg",
"price": 148,
"promotion_price": 148,
"sales": 2866,
"num_iid": 203004819547,
"sample_id": "",
"seller_nick": "啄木鸟清晚田专卖店",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=203004819547"
},
{
"title": "小香风套装裙女秋冬两件套裙子时尚气质贵夫人高档显瘦小西服上衣",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-20/11b73b78660ce240318981f36fedb20b.jpeg",
"price": 106.8,
"promotion_price": 106.8,
"sales": 3585,
"num_iid": 179099550022,
"sample_id": "",
"seller_nick": "蝶之语服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=179099550022"
},
{
"title": "粉色小西装春季新款名媛小香风套装裙两件套韩版时尚百搭收腰显瘦",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-03-17/2c08521a36bae37e004a5cfe15fcddb1.jpeg",
"price": 119,
"promotion_price": 119,
"sales": 136,
"num_iid": 94383041769,
"sample_id": "",
"seller_nick": "小清新职装",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=94383041769"
},
{
"title": "小清新刺绣两件套套装裙兔毛领拼接短外套毛呢连衣裙秋冬甜美新款",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2019-10-07/6f734d1717a3339a74cff707d9ec82c0.jpeg",
"price": 688,
"promotion_price": 688,
"sales": 3602,
"num_iid": 50964999845,
"sample_id": "",
"seller_nick": "木木时尚服饰",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=50964999845"
},
{
"title": "毛呢两件套装裙子女2021春秋季新款中长连衣裙修身妈妈装短款外套",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-03-12/d9b47beb0f7306f132216c910640f830.jpeg",
"price": 89.8,
"promotion_price": 89.8,
"sales": 32000,
"num_iid": 2713732007,
"sample_id": "",
"seller_nick": "露雪颜旗舰店",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=2713732007"
},
{
"title": "白鸭绒2020冬季新款网红苏苏羽绒服女中长款大毛领收腰加厚外套潮",
"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-12-13/735fb9bd599594a424f3f22957aafd06.jpeg",
"price": 299,
"promotion_price": 299,
"sales": 3292,
"num_iid": 45642569064,
"sample_id": "",
"seller_nick": "晗晗羽绒厂家店",
"post_fee": "",
"area": "",
"detail_url": "http://yangkeduo.com/goods.html?goods_id=45642569064"
}
]
},
"error_code": "0000",
"reason": "ok",
"secache": "a8881ed5637e3c7e84f03acdc86be64f",
"secache_time": 1615362351,
"secache_date": "2021-03-10 15:45:51",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:30 max:10000",
"execution_time": 0.649,
"server_time": "Beijing/2021-03-10 15:45:51",
"client_ip": "106.6.35.144",
"call_args": {
"q": "女装",
"start_price": "0",
"end_price": "0",
"page": "1",
"cat": "0"
},
"api_type": "pinduoduo",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "2.92MB",
"request_id": "gw-1.6048792eb5a86"
}
异常示例：
{
"error": "item-not-found",
"reason": "商品没找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "taobao",
"request_id": "15ee0ffc041242"}
如何开通API测试：点击立即开通
以上是从行业内了解到的一些情况，有兴趣的可交流留言（V13879028982 Q1140666069）
