学习目标:
- 快速掌握接口的使用
- 亚马逊的API开发接口,我们需要做下面几件事情。
1)开放平台注册开发者账号;
2)然后为每个淘宝应用注册一个应用程序键(App Key) ;
3)下载亚马逊API的SDK并掌握基本的API基础知识和调用;
4)利用SDK接口和对象,传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发;
5)利用亚马逊平台的文档中心和API测试工具,对接口进行测试。从而了解返回信息,方便程序获取
学习内容:
item_get-获得AMAZON商品详情 [查看演示] API测试工具 注册开通
onebound.amazon.item_get
公共参数
请求地址: https://api-gw.onebound.cn/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 |
0 |
商品链接 |
|
crumbs |
Mix |
0 |
{"162371071": "徒步鞋、登山鞋", "2029189051": "鞋靴", "2112046051": "男鞋", "2112064051": "运动户外鞋"} |
导航列表 |
num_iid |
String |
0 |
B014QN8RG0 |
商品ID |
title |
String |
0 |
Topsky 远行客 户外登山鞋 男鞋耐磨越野跑鞋低帮爬山轻便徒步鞋防滑户外鞋子 休闲透气运动鞋 21907A |
商品标题 |
desc_short |
String |
0 |
秋冬新款 热销推荐 |
商品简介 |
brand |
String |
0 |
品牌名称 |
|
brandId |
Bigint |
0 |
品牌ID |
|
rootCatId |
Bigint |
0 |
2029189051 |
顶级分类ID |
cid |
Bigint |
0 |
162371071 |
|
star |
Int |
0 |
4 |
|
item_imgs |
Mix |
0 |
[{"url": "https://images-cn-4.ssl-images-amazon.com/images/I/51xKSHKPrqL.jpg"}] |
商品图片 |
nick |
String |
0 |
Topsky 远行客 |
卖家昵称 |
num |
Int |
0 |
99 |
|
pic_url |
String |
0 |
//images-cn-4.ssl-images-amazon.com/images/I/61svv4xXUVL._SX466_.jpg |
商品图片 |
currency_code |
String |
0 |
CNY |
当前货币代码 |
price |
Float |
0 |
269.00 |
价格 |
orginal_price |
Float |
0 |
269.00 |
原价 |
type |
String |
0 |
||
seller_cids |
String |
0 |
||
input_pids |
String |
0 |
||
input_str |
String |
0 |
||
item_weight |
String |
0 |
||
valid_thru |
String |
0 |
||
delist_time |
String |
0 |
||
stuff_status |
String |
0 |
||
location |
String |
0 |
发货地 |
|
express_fee |
Float |
0 |
快递费用 |
|
ems_fee |
Float |
0 |
EMS费用 |
|
post_fee |
Float |
0 |
物流费用 |
|
shipping_to |
String |
0 |
发货至 |
|
has_discount |
String |
0 |
||
freight_payer |
String |
0 |
||
has_invoice |
String |
0 |
||
has_warranty |
String |
0 |
||
has_showcase |
String |
0 |
||
increment |
String |
0 |
||
approve_status |
String |
0 |
||
postage_id |
String |
0 |
||
product_id |
String |
0 |
||
auction_point |
String |
0 |
||
item_img |
String |
0 |
||
prop_imgs |
Mix |
0 |
{"prop_img": []} |
商品属性图片列表 |
props_img |
Mix |
0 |
{} |
|
video |
Mix |
0 |
[] |
商品视频 |
outer_id |
String |
0 |
||
is_virtual |
String |
0 |
||
sample_id |
String |
0 |
商品风格标识ID |
|
is_promotion |
String |
0 |
||
props_name |
String |
0 |
0:1:尺寸:40;0:0:尺寸:39;1:4:颜色:;1:2:颜色:;1:0:颜色:军绿色;1:3:颜色:;1:1:颜色:深褐色;1:5:颜色: |
商品属性名 |
property_alias |
String |
0 |
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 |
0 |
卖家ID |
|
shop_id |
Bigint |
0 |
店铺ID |
|
props_list |
Mix |
0 |
{"0:1": "尺寸:40", 1:0": "颜色:军绿色} |
商品属性列表 |
seller_info |
Mix |
0 |
{"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 |
0 |
是否天猫 |
|
error |
String |
0 |
错误信息 |
|
warning |
String |
0 |
警告信息 |
|
url_log |
String |
0 |
||
shopinfo |
Mix |
0 |
{"shop_name": ""} |
店铺信息 |
promo_type |
String |
0 |
||
shop_item |
Mix |
0 |
[] |
|
relate_items |
Mix |
0 |
[] |
|
sku |
Mix |
0 |
{"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 |
0 |
||
pinglun |
Mix |
0 |
[] |
Result Object:
---------------------------------------
{
"item": {
"detail_url": "https://www.amazon.cn/dp/B00AD69V0G?th=1&psc=1",
"crumbs": {
"111082071": "鞋油",
"162417071": "鞋靴配件",
"2029189051": "鞋靴"
},
"title": "ECCO 爱步 鞋子清新剂 60ml 适用于成人鞋",
"desc_short": "",
"brand": "",
"brandId": "",
"end_time": "",
"rootCatId": "2029189051",
"cid": "111082071",
"star": "4-5",
"item_imgs": [
{
"url": "https://images-cn.ssl-images-amazon.cn/images/I/31Z7eT+zbdL._AC_.jpg"
},
{
"url": "https://images-cn.ssl-images-amazon.cn/images/I/41dN-48bR9L._AC_.jpg"
},
{
"url": "https://images-cn.ssl-images-amazon.cn/images/I/31olu7zqgSL._AC_.jpg"
},
{
"url": "https://images-cn.ssl-images-amazon.cn/images/I/219q8guWI9L._AC_.jpg"
}
],
"nick": "ECCO 爱步",
"num": "99",
"num_iid": "B00AD69V0G",
"pic_url": "//images-cn.ssl-images-amazon.cn/images/I/71yOBn-qbZL._AC_UY395_.jpg",
"currency_code": "CNY",
"price": "¥116.04",
"orginal_price": "¥116.04",
"location": "",
"item_weight": "\n \n &lrm",
"item_size": "&rlm",
"post_fee": "",
"express_fee": "",
"prop_imgs": {
"prop_img": [
{
"properties": "1:0",
"url": null
}
]
},
"props_img": {
"1:0": null
},
"props_name": "0:0:尺寸:40 EU/5 M US;1:0:颜色:透明",
"property_alias": "0:0:40 EU/5 M US;1:0:透明",
"props_list": {
"0:0": "尺寸:40 EU/5 M US",
"1:0": "颜色:透明"
},
"seller_info": {
"nick": "ECCO 爱步",
"city": "",
"bail": "",
"level": "",
"rate": "",
"score": "",
"delivery_score": "",
"item_score": "",
"shop_type": "",
"user_num_id": "1",
"sid": "1",
"title": "ECCO 爱步",
"zhuy": "https://www.amazon.cn/",
"company_name": "",
"menu": []
},
"error": "",
"warning": "",
"shopinfo": {
"shop_name": ""
},
"shop_item": [],
"relate_items": [],
"skus": {
"sku": [
{
"price": "¥116.04",
"orginal_price": "¥116.04",
"properties": "0:0;1:0",
"properties_name": "0:0:尺寸:40 EU/5 M US;1:0:颜色:透明",
"quantity": 99,
"sku_id": "B00AD69V0G",
"sku_url": "https://www.amazon.cn/dp/B00AD69V0G?th=1&psc=1"
}
]
},
"desc": "<div> <!-- show up to 2 reviews by default -->\n </div> <img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.62d0e0e9caa5a&p=1778787841&k=i_key&t=1657856236\" style=\"display:none\" />",
"pinglun": [
{
"star": "5",
"title": "Good",
"author": "World shopper",
"time": "2019年11月20日",
"choose": "尺寸: 40 EU/5 M US<i class=\"a-icon a-icon-text-separator\" role=\"img\" aria-label=\"|\"></i>颜色: 透明",
"content": "It's working good."
},
{
"star": "5",
"title": "For inside of shoes",
"author": "WsZ",
"time": "2018年11月28日",
"choose": "尺寸: 40 EU/5 M US<i class=\"a-icon a-icon-text-separator\" role=\"img\" aria-label=\"|\"></i>颜色: 透明",
"content": "In think it works well. Actually I bought it because the recommendation on the web and that I can't wash my leather boots."
},
{
"star": "5",
"title": "Five Stars",
"author": "Aries",
"time": "2014年11月2日",
"choose": "尺寸: 40 EU/5 M US<i class=\"a-icon a-icon-text-separator\" role=\"img\" aria-label=\"|\"></i>颜色: 透明",
"content": "very good"
},
{
"star": "5",
"title": "Five Stars",
"author": "Song Chao",
"time": "2014年10月30日",
"choose": "尺寸: 40 EU/5 M US<i class=\"a-icon a-icon-text-separator\" role=\"img\" aria-label=\"|\"></i>颜色: 透明",
"content": "GOOD"
},
{
"star": "1",
"title": "One Star",
"author": "Jarno Mossou",
"time": "2018年8月23日",
"choose": "尺寸: 40 EU/5 M US<i class=\"a-icon a-icon-text-separator\" role=\"img\" aria-label=\"|\"></i>颜色: 透明",
"content": "It is not working for me"
}
],
"format_check": "ok",
"sales": 0,
"desc_img": []
},
"error": "",
"secache": "65dffdee32e84d2c72cdac09805d947f",
"secache_time": 1657856236,
"secache_date": "2022-07-15 11:37:16",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:24 max:10100 all[65=24+24+17];expires:2030-12-31",
"execution_time": "2.263",
"server_time": "Beijing/2022-07-15 11:37:16",
"client_ip": "106.6.38.1",
"call_args": {
"num_iid": "B00AD69V0G"
},
"api_type": "amazon",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "4.18MB",
"request_id": "gw-1.62d0e0e9caa5a",
"last_id": "1079188430"
}
错误码解释
状态代码(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 |
未知错误 |
否 |
演示图片
登录 - 跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商