1688关键字搜索新品数据API接口（item_search_new-按关键字搜索新品数据）代码接口教程如下：
公共参数
名称 类型 必须 描述
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=衣服&page=1&sort=
参数说明：q：搜索关键字
page:翻页
sort:排序(normal综合,va_rmdarkgmv30rt成交额,bid价格升序，_bid价格降序)
响应参数
Version: Date:
名称 类型 必须 示例值 描述
items
items[] 0 按关键字搜索商品
请求示例
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://wx18870288846/key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=衣服&page=1&sort=";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
响应示例
{
"item": [
{
"title": "男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "2000+",
"num_iid": "669093370636",
"seller_nick": "石狮市领川服装厂",
"tag_percent": "12.3%",
"area": "泉州市",
"sid": "b2b-221326973628972c61",
"detail_url": "https://detail.1688.com/offer/669093370636.html"
},
{
"title": "2022夏季新款印花短袖t恤女网红同款衣服女韩版百搭中长款上衣女",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Ek7mv41S5oV5YcCvp_!!2744312196-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "668773906932",
"seller_nick": "普宁市洪阳戴紫妮服装厂",
"tag_percent": "17.3%",
"area": "普宁市",
"sid": "b2b-285040931583cf0",
"detail_url": "https://detail.1688.com/offer/668773906932.html"
},
{
"title": "抖音质量磨毛双面德绒短袖t恤女立体卡通夏2022新款上衣大码女装",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ihTAw31Vqw6C0UByX_!!2213014272705-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "200+",
"num_iid": "670585170610",
"seller_nick": "广州克里贸易有限公司",
"tag_percent": "9%",
"area": "普宁市",
"sid": "b2b-2213014272705d647f",
"detail_url": "https://detail.1688.com/offer/670585170610.html"
},
{
"title": "韩路女装 2022春夏新款卡通印花短袖T恤女ins风纯棉宽松潮流体恤",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vPvBu722OtAF9rxw2_!!3910967111-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "6万+",
"num_iid": "668912014686",
"seller_nick": "瑞安市萌越贸易有限公司",
"tag_percent": "17%",
"area": "瑞安市",
"sid": "b2b-391096711196312",
"detail_url": "https://detail.1688.com/offer/668912014686.html"
},
{
"title": "撞色条纹短袖针织衫女2022夏季新款休闲百搭别致上衣ins显瘦薄款",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ztb9V421Yg1BzxUC7_!!2213249306997-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "671716125800",
"seller_nick": "广州小仙妮子服装厂",
"tag_percent": "4.7%",
"area": "广州市",
"sid": "b2b-2213249306997da12a",
"detail_url": "https://detail.1688.com/offer/671716125800.html"
},
{
"title": "夏新款潮流男女重磅250克落肩半袖t恤供应学生班服宽松嘻哈街舞服",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lJUgSo1uVkAiNDhwz_!!2209929186043-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "2万+",
"num_iid": "670169572856",
"seller_nick": "广州旺者归莱服装有限公司",
"tag_percent": "10.8%",
"area": "广州市",
"sid": "b2b-22099291860439e3d0",
"detail_url": "https://detail.1688.com/offer/670169572856.html"
},
{
"title": "东南亚跨境全涤男士短袖T恤亚马逊夏季新款短袖上衣时尚潮印花T恤",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01BeqZdv25bf3xdIOEu_!!2213760247545-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1万+",
"num_iid": "671850915594",
"seller_nick": "揭阳市衫少服饰有限公司",
"tag_percent": "6.9%",
"area": "揭阳市",
"sid": "b2b-22137602475451e023",
"detail_url": "https://detail.1688.com/offer/671850915594.html"
},
{
"title": "韩路女装 主推款纯棉短袖T恤女2022春夏新品宽松潮流趣味印花体恤",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01v1B5s322OtADFyEOW_!!3910967111-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "24万+",
"num_iid": "668176444969",
"seller_nick": "瑞安市萌越贸易有限公司",
"tag_percent": "17%",
"area": "瑞安市",
"sid": "b2b-391096711196312",
"detail_url": "https://detail.1688.com/offer/668176444969.html"
},
{
"title": "男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "3万+",
"num_iid": "668987018070",
"seller_nick": "石狮市艾迪斯顿服装厂",
"tag_percent": "15.9%",
"area": "泉州市",
"sid": "b2b-22132036914233b9ff",
"detail_url": "https://detail.1688.com/offer/668987018070.html"
},
{
"title": "当季新品 趋势热卖",
"pic_url": null,
"promotion_price": null,
"price": null,
"sales": null,
"num_iid": null,
"seller_nick": null,
"tag_percent": null,
"area": null,
"sid": null,
"detail_url": "https://detail.1688.com/offer/.html"
},
{
"title": "纯棉t恤男2022夏季新款短袖T恤男圆领半袖宽松潮流衣服打底衫男",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018WnzOm1DmCvnSox0K_!!2212492580258-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "671351089756",
"seller_nick": "汕头市潮阳区铜盂诗美嘉服装厂",
"tag_percent": "8.3%",
"area": "汕头市",
"sid": "b2b-2212492580258e6ac6",
"detail_url": "https://detail.1688.com/offer/671351089756.html"
},
{
"title": "中袖t恤女2022年新款女装气质polo领莫代尔半袖体恤撞色收腰上衣",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN019VuwdN1vYK19Qcjgl_!!2242696184-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "3000+",
"num_iid": "670971673377",
"seller_nick": "广州声歌服饰有限公司",
"tag_percent": "45.4%",
"area": "广州市",
"sid": "b2b-2242696184",
"detail_url": "https://detail.1688.com/offer/670971673377.html"
},
{
"title": "潮迈克男士短袖T恤衣服潮牌潮流半袖男装2022新款夏季修身体恤衫",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01k1ZXYL2N3uxtkFbjD_!!2212460019908-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "200+",
"num_iid": "671819478208",
"seller_nick": "石狮市祥志日用品商行",
"tag_percent": "9.7%",
"area": "",
"sid": "b2b-22124600199086d3a0",
"detail_url": "https://detail.1688.com/offer/671819478208.html"
},
{
"title": "100%棉t恤短袖男修身潮流纯色280g丝光棉男士半袖圆领上衣中青年",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018rR3nq1Yidm4jNvRE_!!2212372513093-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "7000+",
"num_iid": "669931288096",
"seller_nick": "桐乡市梧桐辉诺服饰商行",
"tag_percent": "16.3%",
"area": "桐乡市",
"sid": "b2b-22123725130939dd36",
"detail_url": "https://detail.1688.com/offer/669931288096.html"
},
{
"title": "2022新款弹力直筒打底上衣五分袖小衫网纱立领印花T恤女装夏季潮",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01nx3VpR23uJy6lgtVW_!!2260697315-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "400+",
"num_iid": "671337941177",
"seller_nick": "潮州市潮安区金石镇骏龙制衣厂",
"tag_percent": "39.7%",
"area": "潮州市",
"sid": "b2b-2260697315",
"detail_url": "https://detail.1688.com/offer/671337941177.html"
},
{
"title": "厂家直销翻领冰丝短袖t恤男式商务休闲条纹宽松薄款Polo衫男装潮",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lur0VS1uqoOGKJYOf_!!2213204496089-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "700+",
"num_iid": "669987872360",
"seller_nick": "桐乡市濮院柏梁服装厂",
"tag_percent": "19%",
"area": "桐乡市",
"sid": "b2b-221320449608977b92",
"detail_url": "https://detail.1688.com/offer/669987872360.html"
},
{
"title": "现货供应休闲日系短袖T恤男绣潮流日式绣花贴布圆领T恤男外贸衫",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01o0ZM4b29ayw5yQoaR_!!2209917828085-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "300+",
"num_iid": "670628937468",
"seller_nick": "广州市云格服饰有限公司",
"tag_percent": "35.1%",
"area": "广州市",
"sid": "b2b-2209917828085ceab7",
"detail_url": "https://detail.1688.com/offer/670628937468.html"
},
{
"title": "TKPA高街头复古美式oldschool做旧水洗徽章i短袖T恤男女ins国潮牌",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01FMyJtv1fE8i6JzwT7_!!3344093974-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "600+",
"num_iid": "670665770082",
"seller_nick": "广州悦享商贸有限公司",
"tag_percent": "32.7%",
"area": "广州市",
"sid": "b2b-334409397456d89",
"detail_url": "https://detail.1688.com/offer/670665770082.html"
},
{
"title": "中年男士T恤宽松爸爸夏装短袖宽条纹夏季上衣服有口袋中",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01s8ypcK1jD07xKzQhW_!!2211188044513-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "500+",
"num_iid": "671263051411",
"seller_nick": "桐乡市濮院弘伙服装厂",
"tag_percent": "18%",
"area": "嘉兴市",
"sid": "b2b-2211129648221b6b4d",
"detail_url": "https://detail.1688.com/offer/671263051411.html"
},
{
"title": "2022夏季新款宽松T恤短款温柔风上衣条纹冰丝针织衫女短袖",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01XFne181n3A8yzQGA0_!!2213769605033-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "700+",
"num_iid": "671604715165",
"seller_nick": "广州觅婷阁服装商行",
"tag_percent": null,
"area": "广州市",
"sid": "b2b-2213769605033305d4",
"detail_url": "https://detail.1688.com/offer/671604715165.html"
},
{
"title": "2022夏季新款五分袖t恤小清新连帽抽绳百搭休闲青少年套头衫上衣",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ODtwTy1oe5h8ZddYU_!!2212454665249-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "670454273152",
"seller_nick": "石狮市崛夜雪锋服装厂",
"tag_percent": "16.3%",
"area": "石狮市",
"sid": "b2b-2212454665249d3f37",
"detail_url": "https://detail.1688.com/offer/670454273152.html"
}
],
"data_from": "1688app",
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:19 max:11000",
"execution_time": "2.566",
"server_time": "Beijing/2022-04-15 15:33:41",
"client_ip": "106.6.33.38",
"call_args": [],
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "4.29MB",
"request_id": "gw-1.62591fd317826",
"last_id": "886371758"}