如何获得阿里巴巴中国站店铺的所有商品 API 返回值说明

item_search_shop-获得店铺的所有商品

1688.item_search_shop

公共参数

请求地址: https://api-gw-4.cn/1688/item_search_shop

名称类型必须描述
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店铺的所有商品

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw-4.cn/1688/item_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid="

响应示例

{
	"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未知错误

API 工具

阿里巴巴中国站的API返回值可能会随着API的更新和迭代而有所变化。对于获得店铺的所有商品这一功能,API的返回值通常会包含店铺内所有商品的详细信息,如商品ID、商品标题、价格、图片链接、描述、销售数量、库存量等。

下面是一个简化的示例,描述了可能的API返回值结构:

```json
{
  "status": "success",
  "message": "商品列表获取成功",
  "data": {
    "total_count": 100,
    "items": [
      {
        "item_id": "123456",
        "title": "示例商品1",
        "price": "19.99",
        "image_url": "http://example.com/image1.jpg",
        "description": "这是一个示例商品的描述。",
        "sales_count": 50,
        "stock_quantity": 100
      },
      {
        "item_id": "789012",
        "title": "示例商品2",
        "price": "29.99",
        "image_url": "http://example.com/image2.jpg",
        "description": "这是另一个示例商品的描述。",
        "sales_count": 30,
        "stock_quantity": 80
      },
      // 更多商品信息...
    ]
  }
}
```

在这个示例中:

- `status` 和 `message` 字段用于表示请求的状态和相关信息。
- `data` 字段包含商品列表的详细信息。
- `total_count` 表示商品的总数。
- `items` 是一个数组,包含每个商品的详细信息。
- `item_id` 是商品的唯一标识符。
- `title` 是商品的标题。
- `price` 是商品的价格。
- `image_url` 是商品的图片链接。
- `description` 是商品的描述。
- `sales_count` 表示商品的销售数量。
- `stock_quantity` 表示商品的库存量。

请注意,这只是一个示例,并不代表阿里巴巴中国站实际的API返回值。为了获得准确的返回值说明,你应该查阅阿里巴巴中国站提供的官方API文档或联系他们的技术支持以获取最新的信息。此外,API调用通常需要提供特定的参数,如API密钥(key)和调用密钥(secret),以确保请求的安全性和身份验证。

  • 30
    点赞
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值