按图搜索淘宝商品(拍立淘) API 返回值说明
请求参数
请求参数:imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=
参数说明:imgid:图片地址(支持淘宝或天猫图片地址,外部地址先调用上传图片(upload_img)接口,返回图片地址)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
响应参数 获取key和密钥
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
title |
String | 0 | 亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮 | 宝贝标题 |
cid |
Int | 0 | 50015374 | |
list_type |
String | 0 | 外观相似宝贝 | 列表类型 |
pic_url |
String | 0 | //g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg | 宝贝图片 |
promotion_price |
String | 0 | 38.71 | 优惠价 |
price |
Float | 0 | 39.50 | 价格 |
sales |
Int | 0 | 7 | 销量 |
num_iid |
Bigint | 0 | 575727312808 | 宝贝ID |
sample_id |
Bigint | 0 | 1627115368 | 商品风格标识ID |
seller_nick |
String | 0 | 专属味道之dzw | 掌柜昵称 |
is_tmall |
Bool | 0 | false | |
post_fee |
String | 0 | 0.00 | 物流费用 |
area |
String | 0 | 广东 东莞 | 店铺所在地 |
detail_url |
String | 0 | //item.taobao.com/item.htm?id=575727312808&ns=1#detail | 宝贝链接 |
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/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}