阿里巴巴中国站获得店铺的所有商品 API接口item_search_shop

在阿里巴巴中国站(1688.com)上,要获取店铺的所有商品,目前没有直接命名为item_search_shop的官方API接口。阿里巴巴开放平台提供了丰富的API接口,但具体的接口名称和功能可能会随着平台的更新而有所变化。

为了获取店铺的所有商品,你可能需要组合使用多个API接口。通常,你可能需要先通过店铺相关的API接口获取店铺信息,然后再使用商品搜索或列表接口,结合店铺ID等参数,来检索该店铺下的商品。

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid=

参数说明:seller_nick:sid或者加密后的_sopid:_sopid@BBBSvyqimnYtLnmm90B_59dsg(详情接口可返回nick参数)
sort:排序[bid,_bid,_sale,_credit]
  (bid:总价(升序)_bid:总价(降序),sale:销量,默认综合排序,time:新品)
sort=new为店铺上新数据,格式不统一,请注意
page:页数

响应参数

Version: Date:

名称类型必须示例值描述

items

items[]0店铺的所有商品

 

响应示例

{
	"user": {
		"id": null,
		"nick": null,
		"good_num": null,
		"level": null,
		"created": null,
		"shop_type": null,
		"user_num_id": null,
		"company_id": null,
		"company_dj": null,
		"company_time": null,
		"company_info": null,
		"cid": "-1",
		"sid": null,
		"pic_url": null,
		"video": null,
		"title": null,
		"address": null,
		"phone": null,
		"zhuy": "./page/contactinfo.htm",
		"fh_score": null,
		"hm_score": null,
		"xy_score": null,
		"ht_score": null,
		"menu": null
	},
	"items": {
		"item": [
			{
				"num_iid": "629206406356",
				"title": "天语欧博信米图手机X27S Mate30 P40 Pro个性简约时尚手机壳批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/782/417/21694714287_2101792098.jpg",
				"price": "19.9",
				"detail_url": "https://m.1688.com/offer/629206406356.html"
			},
			{
				"num_iid": "606991177049",
				"title": "大容量10000毫安全新爆款移动电源自带线充电宝礼品厂家直销",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2019/517/800/12487008715_2101792098.jpg",
				"price": "39.9",
				"detail_url": "https://m.1688.com/offer/606991177049.html"
			},
			{
				"num_iid": "603067013582",
				"title": "P3跨境新爆款现货6.5寸水滴大屏全网通4G智能手机海外代发OEM定制",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2019/492/814/12111418294_2101792098.jpg",
				"price": "52.0",
				"detail_url": "https://m.1688.com/offer/603067013582.html"
			},
			{
				"num_iid": "613515982791",
				"title": "5.8寸大屏工作室root纯净版2+16G云群控抖音快手微信手机OEM批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/270/438/13682834072_2101792098.jpg",
				"price": "66.0",
				"detail_url": "https://m.1688.com/offer/613515982791.html"
			},
			{
				"num_iid": "637339319017",
				"title": "P40 Pro品牌爆款6.5寸水滴大屏8+256G全网通5G安卓智能手机批代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/278/368/16085863872_2101792098.jpg",
				"price": "298.0",
				"detail_url": "https://m.1688.com/offer/637339319017.html"
			},
			{
				"num_iid": "632168014097",
				"title": "新款30pro 7.5寸水滴大屏8+256G全网通5G低价智能手机正品代批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2019/048/299/12073992840_2101792098.jpg",
				"price": "298.0",
				"detail_url": "https://m.1688.com/offer/632168014097.html"
			},
			{
				"num_iid": "624579363633",
				"title": "mate30 pro新款6.5英寸水滴大屏8+256G全网通5G低价智能手机批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/285/407/17053704582_2101792098.jpg",
				"price": "298.0",
				"detail_url": "https://m.1688.com/offer/624579363633.html"
			},
			{
				"num_iid": "624015201074",
				"title": "新款X27 6.5寸全面水滴大屏8+128G全网通5G安卓智能手机批代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2019/469/649/11428946964_2101792098.jpg",
				"price": "298.0",
				"detail_url": "https://m.1688.com/offer/624015201074.html"
			},
			{
				"num_iid": "634673693747",
				"title": "真新款mate40 pro 7.2寸水滴大屏8+256G全网通5G低价智能手机批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vYUdfL1ZrAfnyJVZy_!!6000000003247-0-cib.jpg",
				"price": "299.0",
				"detail_url": "https://m.1688.com/offer/634673693747.html"
			},
			{
				"num_iid": "634599513272",
				"title": "新款mate40 pro 7.2寸水滴大屏10+256G全网通5G低价智能手机批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01hXorlV24Cdi8vAod4_!!6000000007355-0-cib.jpg",
				"price": "299.0",
				"detail_url": "https://m.1688.com/offer/634599513272.html"
			},
			{
				"num_iid": "589766232746",
				"title": "新款X27 6.5寸全面水滴大屏8+128G全网通5G安卓智能手机批代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/976/670/13387076679_2101792098.jpg",
				"price": "308.0",
				"detail_url": "https://m.1688.com/offer/589766232746.html"
			},
			{
				"num_iid": "636684457600",
				"title": "爆款hviv mate30 pro6.8寸水滴大屏256G全网通低价智能手机批代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/610/814/19520418016_2101792098.jpg",
				"price": "398.0",
				"detail_url": "https://m.1688.com/offer/636684457600.html"
			},
			{
				"num_iid": "622583886323",
				"title": "爆款Hviv Mate40Pro+6.8寸水滴大屏512G全网通低价智能手机批代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01O9vUUY285Y3UOWbWL_!!2200733087881-0-cib.jpg",
				"price": "399.0",
				"detail_url": "https://m.1688.com/offer/622583886323.html"
			},
			{
				"num_iid": "589984649469",
				"title": "6.5寸大屏安卓9.0工作室root纯净版4+64G云群控抖音快手阅读手机",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2019/242/368/10339863242_902098348.jpg",
				"price": "469.0",
				"detail_url": "https://m.1688.com/offer/589984649469.html"
			},
			{
				"num_iid": "617854475887",
				"title": "电视话购物工作室root纯净版4+64G云群控抖音快手微信手机OEM批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2019/382/361/12287163283_2101792098.jpg",
				"price": "698.0",
				"detail_url": "https://m.1688.com/offer/617854475887.html"
			},
			{
				"num_iid": "624494524174",
				"title": "爆款hviv mate30 pro6.8寸水滴大屏256G全网通低价智能手机批代发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/876/517/19593715678_2101792098.jpg",
				"price": "998.0",
				"detail_url": "https://m.1688.com/offer/624494524174.html"
			},
			{
				"num_iid": "630981381989",
				"title": "品牌P40 Pro+7.5寸水滴大屏10+256G全网通低价智能手机正品代批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/062/412/20219214260_2101792098.jpg",
				"price": "1199.0",
				"detail_url": "https://m.1688.com/offer/630981381989.html"
			}
		],
		"total_results": "17",
		"page_size": 20,
		"pagecount": 1,
		"page": "1",
		"url": null
	},
	"error": "",
	"secache": "3bbcb618f225b45561bbb1686d15b91c",
	"secache_time": 1615280560,
	"secache_date": "2021-03-09 17:02:40",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:8 max:10000",
	"execution_time": 7.492,
	"server_time": "Beijing/2021-03-09 17:02:40",
	"client_ip": "106.6.35.144",
	"call_args": {
		"nick": "b2b-2200733087881719de"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "3.56MB",
	"request_id": "gw-4.604739a9443f6"
}

 异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}

错误码解释

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

 

以下是一般情况下可能涉及的步骤和考虑因素:

  1. 获取店铺信息:首先,你可能需要使用一个店铺信息相关的API接口,如shop_get或类似的接口,来获取店铺的基本信息,包括店铺ID等。

  2. 构造商品搜索请求:然后,你可以使用商品搜索或列表接口来检索商品。这些接口通常允许你通过店铺ID作为筛选条件来限制搜索结果。具体的接口名称可能是item_searchitem_list或其他类似的名称,具体取决于阿里巴巴开放平台的当前API文档。

  3. 分页处理:由于一个店铺可能拥有大量的商品,API接口通常会采用分页的方式返回结果。你需要根据接口提供的分页参数(如页码和每页数量)来逐页获取商品信息。

  4. 处理响应数据:发送请求并接收响应后,你需要解析响应数据,提取出商品列表信息。这通常包括商品ID、商品名称、价格、图片等字段。

请注意,为了使用阿里巴巴开放平台的API接口,你需要先在平台上注册并创建应用,获取API调用权限和必要的凭证(如App Key和App Secret)。此外,你还应遵守阿里巴巴的使用规则和限制,确保你的请求频率和数据使用量在合理的范围内。

由于阿里巴巴平台的API接口和功能可能会不断更新和变化,建议你直接查阅阿里巴巴开放平台的官方API文档,以获取最准确和最新的接口信息和使用指南。在文档中,你可以找到详细的接口说明、参数列表、请求示例和返回结果示例,帮助你更好地理解和使用相关API接口。

  • 18
    点赞
  • 16
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值