1688阿里巴巴官方开放平台API接口获取商品详情、商品规格信息列表、价格、宝贝详情数据调用示例说明

商品详情API接口在电商平台和购物应用中的作用非常重要。它提供了获取商品详细信息的能力,帮助用户了解和选择合适的商品,同时也支持开发者进行竞品分析、市场研究和推广营销等工作,以提高用户体验和促进销售增长。

1688.item_get-获得1688商品详情

公共参数

名称 类型 必须 描述
key String 调用key(必须以GET方式拼接在URL中)注册key请求接入
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版本

请求参数

请求参数:num_iid=610947572360

参数说明:num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据

响应参数

Version: Date:

名称 类型 必须 示例值 描述

item

item[] 0 宝贝详情数据

num_iid

String 0 610947572360 宝贝ID

title

String 0 厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G 商品标题

desc_short

String 0 商品简介

price

Float 0 799.00 价格

total_price

Float 0 0

suggestive_price

Float 0 0

orginal_price

Float 0 799.00 原价

nick

String 0 qin多亲科技 卖家昵称

num

Int 0 2191

detail_url

String 0 https://detail.1688.com/offer/610947572360.html 宝贝链接

pic_url

String 0 https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg 宝贝图片

brand

String 0 MAJE 品牌

brandId

Int 0 8879363 品牌id

rootCatId

Int 0 0 顶级分类ID

cid

Int 0 124264005

desc

String 0

item_imgs

Mix 0 item_imgs[] 商品图片

item_weight

String 0

post_fee

Float 0 9.00 邮费

express_fee

Float 0 9.00 EMS费用

ems_fee

Float 0 9.00 物流费用

shipping_to

String 0 广东广州白云区 发货至

video

video[] 0 商品视频

sample_id

String 0

props_name

String 0 0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色 商品属性名

prop_imgs

prop_imgs[] 0 商品属性图片列表

property_alias

String 0 0:0:64GB;1:0:铁灰色;1:1:瓷白色 属性别名

props

Mix 0 [{"name": "品牌", "value": "other"}] 商品详情

total_sold

Int 0 1

scale

Int 0

sellUnit

Int 0

skus

skus[] 0 商品规格信息列表

seller_id

Int 0 2206619673102 卖家ID

sales

Int 0 100 销售额

shop_id

Int 0 151372205 店铺ID

props_list

Mix 0 {"0:0": "机身内存:64GB"} 商品属性

seller_info

seller_info[] 0 卖家信息

tmall

Boolean 0 false 是否天猫

data_from

String 0 1688app 错误信息

error

String 0 错误信息

unit

String 0 部; 单位

is_support_mix

Boolean 0 true

mix_amount

Int 0 30

mix_Begin

Int 0

mix_number

Int 0

sales_data

Date 0

location

String 0 广东省 深圳市 发货地

props_img

Mix 0 属性图片

sales_info

Mix 0

desc_img

Mix 0 [{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}] 详情图片列表

shop_item

Mix 0

relate_items

Mix 0

Java请求示例(Curl、PHP、PHPsdk、JAVA、C#、Python、Golang、JS-SDK、Ruby、Swift、javascript、Objective-C、C、C++...)

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://1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}

响应示例

{
	"item": {
		"num_iid": "610947572360",
		"title": "厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G",
		"desc_short": "",
		"price": "799.00",
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "799.00",
		"nick": "qin多亲科技",
		"num": "1763",
		"detail_url": "https://detail.1688.com/offer/610947572360.html",
		"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg",
		"brand": "",
		"brandId": "",
		"rootCatId": "",
		"cid": "50903",
		"desc": "

深圳市多亲科技有限公司(简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发,在人工智能终端设备、系统软件的研发和生产领域,具有深厚的技术沉淀与实力。

 

        多亲产品销售网络覆盖全国各地乃至远销海外,欢迎企业定制、团购、经销代理。

        优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。

        欢迎有意向者实地考察,垂询电话:13662284449.

 

温馨提示:

1、可定制--承接各种订单订制!为客户定制机身、开机画面、预装软件、包装等定制!
2、质量保证--本公司专注通讯行业10年,线下线下百花齐放,客户复购率达30%以上。
3、价格实惠--本店是工厂直供,没有中间商差价,一站到客,薄利多销。
4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货(非人为因素)30天内换新。

 

\"undefined\"
\"undefined\"
\"undefined\"
\"undefined\"

\"undefined\"

\"undefined\"

\"undefined\"

\"undefined\"
\"undefined\"

\"undefined\"
\"undefined\"
\"undefined\"
\"undefined\"
\"undefined\"

\"undefined\"

\"undefined\"
\"undefined\"

\"undefined\"
\"undefined\"
\"undefined\"

\"undefined\"

\"undefined\"
\"undefined\"
\"undefined\"

\"undefined\"
\"undefined\"
\"undefined\"

\"undefined\"

\"undefined\"
\"undefined\"

\"undefined\"

\"undefined\"

\"undefined\"

\"undefined\"
\"undefined\"

\"undefined\"
\"undefined\"

\"undefined\"


", "item_imgs": [ { "url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/2020/445/748/13819847544_979836901.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/2020/487/543/13234345784_979836901.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/2020/296/695/13418596692_979836901.jpg" }, { "url": "https://cbu01.alicdn.com/img/ibank/2020/167/778/13462877761_979836901.jpg" } ], "item_weight": "", "post_fee": "", "express_fee": "", "ems_fee": "", "shipping_to": "", "video": [], "sample_id": "", "props_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色", "prop_imgs": { "prop_img": [] }, "property_alias": "0:0:64GB;1:0:铁灰色;1:1:瓷白色", "props": [ { "name": "品牌", "value": "多亲" }, { "name": "型号", "value": "Qin 2 Pro" }, { "name": "手机类型", "value": "老人手机" }, { "name": "外形", "value": "直板" }, { "name": "主屏尺寸", "value": "大屏幕(5.0英寸—5.9英寸)" }, { "name": "网络制式", "value": "移动4G(TD-LTE),联通/电信4G(FDD-LTE)" }, { "name": "操作系统", "value": "Android 9.0系统" }, { "name": "电池容量", "value": "2100" }, { "name": "摄像头像素", "value": "1200万-1999万" }, { "name": "存储卡", "value": "支持存储卡" }, { "name": "处理器核心", "value": "八核" }, { "name": "运行内存", "value": "2GB" }, { "name": "手机版本", "value": "大陆行货" }, { "name": "售后类型", "value": "全国联保" }, { "name": "上市时间", "value": "2019" }, { "name": "适用送礼场合", "value": "员工福利,颁奖纪念,广告促销,节日,展销会,公关策划,生日,商务馈赠" }, { "name": "3C证书编号", "value": "2019161606319519" }, { "name": "CPU品牌", "value": "展讯" }, { "name": "运营商", "value": "中国移动,中国电信,中国联通" }, { "name": "网络模式", "value": "单卡单模" }, { "name": "机身内存", "value": "64GB" }, { "name": "颜色", "value": "铁灰色,瓷白色" }, { "name": "电信设备进网许可证编号", "value": "02-B613-192425" } ], "total_sold": "1", "scale": "", "sellUnit": "", "skus": { "sku": [ { "price": "799.00", "total_price": 0, "sales": "55", "properties": "0:0;1:1", "properties_name": "0:0:机身内存:64GB;1:1:颜色:瓷白色", "quantity": "932", "sku_id": "4309097072612", "spec_id": "63828b15ad641fdb131775f32e4c050c" }, { "price": "799.00", "total_price": 0, "sales": "159", "properties": "0:0;1:0", "properties_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色", "quantity": "831", "sku_id": "4302217872901", "spec_id": "0eb631954bfe8fb00a45824fc6193f2f" } ] }, "seller_id": "2206619673102", "sales": 30, "shop_id": "", "props_list": { "0:0": "机身内存:64GB", "1:0": "颜色:铁灰色", "1:1": "颜色:瓷白色" }, "seller_info": { "nick": "qin多亲科技", "user_num_id": "2206619673102", "sid": "b2b-2206619673102e9470", "title": "深圳多亲科技实力卖场", "zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470", "shop_name": "qin多亲科技" }, "tmall": "", "data_from": "1688app", "error": "", "unit": "部", "is_support_mix": null, "mix_amount": null, "mix_begin": null, "mix_number": null, "min_num": "2", "sales_data": "", "location": "广东省 深圳市", "props_img": [], "sales_info": { "seller_num": "", "repeat_rate_purchase": "", "per_capita_purchases": "", "comment_num": "", "comment_url": "" }, "desc_img": [ "https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg", "https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg" ], "shop_item": [], "relate_items": [] }, "secache": "f75c59301daa3fc1610a8563c998f851", "secache_time": 1608276252, "secache_date": "2020-12-18 15:24:12", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:12 max:10000", "execution_time": 6.65, "server_time": "Beijing/2020-12-18 15:24:17", "client_ip": "182.111.155.89", "call_args": { "num_iid": "610947572360", "area_id": "440111" }, "api_type": "1688", "translate_language": "zh-CN", "translate_engine": "google_cn", "server_memory": "4.44MB", "request_id": "gw-2.5fdc591b3bdb0" }

你可能感兴趣的:(数据库,学习分享,api,java,数据库,开发语言,数据挖掘,前端)