《拼多多电商业务场景》批量采集产品数据根据关键词获取商品列表示例
关键词搜索商品接口的主要功能是根据用户提供的关键字进行商品搜索，并返回与关键字相关的商品列表。具体功能包括以下几点：
- 关键字匹配：接口会将用户提供的关键字与电商平台的商品信息进行匹配，找出与之相关的商品。
- 搜索排序：接口可以按照一定的规则对搜索结果进行排序，例如按照商品的销量、价格、评分等进行排序，以提供更符合用户需求的搜索结果。
- 分页查询：接口支持分页查询，用户可以通过设置页码和每页条数来获取不同页的搜索结果。
- 筛选条件：接口可以根据用户的需求，提供一些筛选条件供用户选择，例如品牌、价格区间、商品类型等。
- 搜索建议：接口可以根据用户输入的关键字，提供搜索建议，帮助用户快速找到相关的商品。
pinduoduo.item_search-根据关键词取商品列表
公共参数
请求地址: 注册调用key接入
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
| lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
| version | String | 否 | API版本 |
请求参数
请求参数：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:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| items |
items[] | 0 | 根据关键词取商品列表 | |
| title |
String | 0 | 啄木鸟双面穿棉衣女2020冬装加厚宽松韩版棉袄小个子羽绒棉外套冬 | 商品标题 |
| pic_url |
String | 0 | https://t00img.yangkeduo.com/goods/images/2020-12-08/1226cd586487b63527d86fdabb8608cc.jpeg | 宝贝图片 |
| price |
Float | 0 | 198 | 价格 |
| promotion_price |
Float | 0 | 198 | 优惠价格 |
| sales |
Int | 0 | 14830 | 销量 |
| num_iid |
Bigint | 0 | 203344831134 | 宝贝ID |
| sample_id |
String | 0 | 商品风格标识ID | |
| seller_nick |
String | 0 | 时沫女装专营店 | 掌柜昵称 |
| post_fee |
Float | 0 | 物流费用 | |
| area |
String | 0 | 店铺所在地 | |
| detail_url |
String | 0 | http://yangkeduo.com/goods.html?goods_id=203344831134 | 宝贝链接 |
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://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());
}
}响应示例
{
"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"