亚马逊AMAZON中国站API详情接口获取商品详情接口

Cris20230328 / 2023-05-18 / 原文

亚马逊中国站是亚马逊在中国开设的在线购物平台，提供包括图书、电子产品、家居生活、服饰鞋包等各类品类的商品。亚马逊为了满足中国消费者的需求，特别推出了全球购和自营模式两种购物方式，全球购支持跨境购物，自营模式则是由亚马逊直接发货并提供售后服务。同时，亚马逊还提供了一系列的优惠活动，如每日特价、秒杀等，以及会员制度和积分制度，让消费者可以享受更多的折扣和福利。除此之外，亚马逊中国站也注重客户体验，在网站上设置了专业的购物指南、购物攻略、售后服务等功能，帮助消费者更好地进行在线购物。总的来说，亚马逊中国站是一个方便、安全、优惠的在线购物平台，深受中国消费者的喜爱。

获取商品详情接口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://v-;18870288846/amazon/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=B016LO4UTA";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}

amazon.item_get

公共参数

名称	类型	必须	描述
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版本

请求测试

请求参数：num_iid=B016LO4UTA

参数说明：num_iid:AMAZON商品ID（非.cn的请在后加 -com）

响应参数

Version: Date:

名称	类型	示例值	描述
detail_url	String	https://www.amazon.cn/dp/B014QN8RG0?th=1&psc=1	商品链接
crumbs	Mix	{"162371071": "徒步鞋、登山鞋", "2029189051": "鞋靴", "2112046051": "男鞋", "2112064051": "运动户外鞋"}	导航列表
num_iid	String	B014QN8RG0	商品ID
title	String	Topsky 远行客户外登山鞋男鞋耐磨越野跑鞋低帮爬山轻便徒步鞋防滑户外鞋子休闲透气运动鞋 21907A	商品标题
desc_short	String	秋冬新款热销推荐	商品简介
brand	String		品牌名称
brandId	Bigint		品牌ID
rootCatId	Bigint	2029189051	顶级分类ID
cid	Bigint	162371071
star	Int	4
item_imgs	Mix	[{"url": "https://images-cn-4.ssl-images-amazon.com/images/I/51xKSHKPrqL.jpg"}]	商品图片
nick	String	Topsky 远行客	卖家昵称
num	Int	99
pic_url	String	//images-cn-4.ssl-images-amazon.com/images/I/61svv4xXUVL._SX466_.jpg	商品图片
currency_code	String	CNY	当前货币代码
price	Float	269.00	价格
orginal_price	Float	269.00	原价
type	String
seller_cids	String
input_pids	String
input_str	String
item_weight	String
valid_thru	String
delist_time	String
stuff_status	String
location	String		发货地
express_fee	Float		快递费用
ems_fee	Float		EMS费用
post_fee	Float		物流费用
shipping_to	String		发货至
has_discount	String
freight_payer	String
has_invoice	String
has_warranty	String
has_showcase	String
increment	String
approve_status	String
postage_id	String
product_id	String
auction_point	String
item_img	String
prop_imgs	Mix	{"prop_img": []}	商品属性图片列表
props_img	Mix	{}
video	Mix	[]	商品视频
outer_id	String
is_virtual	String
sample_id	String		商品风格标识ID
is_promotion	String
props_name	String	0:1:尺寸:40;0:0:尺寸:39;1:4:颜色:;1:2:颜色:;1:0:颜色:军绿色;1:3:颜色:;1:1:颜色:深褐色;1:5:颜色:	商品属性名
property_alias	String	0:1:40;1:4:;0:1:40;1:2:;0:0:39;1:0:军绿色;0:1:40;1:3:;0:1:40;1:1:深褐色;0:1:40;1:0:军绿色;0:0:39;1:5:;0:0:39;1:4:;0:0:39;1:3:;0:1:40;1:5:	商品属性别名
seller_id	Bigint		卖家ID
shop_id	Bigint		店铺ID
props_list	Mix	{"0:1": "尺寸:40", 1:0": "颜色:军绿色}	商品属性列表
seller_info	Mix	{"nick": "Topsky 远行客", "city": "", "bail": "", "level": "", "rate": "", "score": "", "delivery_score": "", "item_score": "", "shop_type": "", "user_num_id": "1", "sid": "1", "title": "Topsky 远行客", "zhuy": "https://www.amazon.cn/", "company_name": "", "menu": []}	卖家信息
tmall	Boolean		是否天猫
error	String		错误信息
warning	String		警告信息
url_log	String
shopinfo	Mix	{"shop_name": ""}	店铺信息
promo_type	String
shop_item	Mix	[]
relate_items	Mix	[]
sku	Mix	{"sku": [{"price": "269.00", "orginal_price": "269.00", "properties": "0:1;1:4", "properties_name": "0:1:尺寸:40;1:4:颜色:", "quantity": 0, "sku_id": "B014QN8VFM", "sku_url": "https://www.amazon.cn/dp/B014QN8VFM?th=1&psc=1"}]}	商品规格信息列表
desc	String
pinglun	Mix	[]

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否