一、参数
公共参数
请求地址: https://api-gw.onebound.cn/yiwugo/item_search_img
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:imgid=http://img1.yiwugou.com/i004/2018/03/19/19/3753c1a6a6452559f21f6d424b99f1f2.jpg&cat=&page=
参数说明:imgid:图片地址(使用淘宝upload_img接口上传图片,返回图片地址)
如:http://img1.yiwugou.com/i004/2018/03/19/19/3753c1a6a6452559f21f6d424b99f1f2.jpg
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
title | String | 0 | CF111-4光身尖勺 430不锈钢勺 中西餐餐勺 四号尖勺 厂家直销 | 宝贝标题 |
pic_url | String | 0 | //img1.yiwugou.com/i004/2018/03/19/68/8cce82af5f2796ed367189b561849902.jpg | 宝贝图片 |
promotion_price | Float | 0 | 0.90 | 优惠价 |
price | Float | 0 | 0.90 | 价格 |
price_range | Mix | 0 | 价格范围 | |
sales | Int | 0 | 5 | 销量 |
num_iid | Bigint | 0 | 929115901 | 宝贝ID |
sample_id | String | 0 | 商品风格标识ID | |
seller_nick | String | 0 | 诚发餐具 | 卖家昵称 |
post_fee | Int | 0 | 0 | 物流费用 |
area | String | 0 | 广东中山市 | 店铺所在地 |
seller_id | String | 0 | 0435736A | |
seller_url | String | 0 | //www.yiwugo.com/hu/0435736A.html | |
seller_addr | String | 0 | 地址 | |
shopid | Int | 0 | 532501 | 店铺ID |
二、示例
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/yiwugo/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://img1.yiwugou.com/i004/2018/03/19/19/3753c1a6a6452559f21f6d424b99f1f2.jpg&cat=&page="
响应示例
{
"items": {
"url": "http://img.yiwugo.com/search.html?url=http%3A%2F%2Fimg1.yiwugou.com%2Fi004%2F2018%2F03%2F19%2F19%2F3753c1a6a6452559f21f6d424b99f1f2.jpg&cpage=",
"list_page": "",
"real_total_results": "81",
"total_results": "81",
"pagecount": 5,
"item": [
{
"title": "诚发CF111-1光身尖勺 不锈钢勺 西餐勺 一号尖勺 餐具厨具",
"pic_url": "//img1.yiwugou.com/i004/2015/05/07/91/1bfbdda952333a510ba394c69ba80696.jpg",
"price": "1.20",
"promotion_price": "1.20",
"price_range": "",
"sales": 50,
"num_iid": "926676752",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736B",
"seller_url": "//www.yiwugo.com/hu/0435736B.html",
"seller_addr": "",
"shopid": "532506"
},
{
"title": "CF111-5光身尖勺 430不锈钢勺 中西餐餐勺 五号尖勺 厂家直销",
"pic_url": "//img1.yiwugou.com/i004/2018/03/19/19/3753c1a6a6452559f21f6d424b99f1f2.jpg",
"price": "0.80",
"promotion_price": "0.80",
"price_range": "",
"sales": 5,
"num_iid": "929115896",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736A",
"seller_url": "//www.yiwugo.com/hu/0435736A.html",
"seller_addr": "",
"shopid": "532501"
},
{
"title": "诚发CF111-4光身尖勺 不锈钢勺 西餐勺 四号尖勺 餐具厨具",
"pic_url": "//img1.yiwugou.com/i004/2015/05/07/54/dfdcd8fd6671fa361952cbcfe40f7b09.jpg",
"price": "0.90",
"promotion_price": "0.90",
"price_range": "",
"sales": 50,
"num_iid": "926678426",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736B",
"seller_url": "//www.yiwugo.com/hu/0435736B.html",
"seller_addr": "",
"shopid": "532506"
},
{
"title": "诚发CF111-2光身尖勺 不锈钢勺 西餐勺 二号尖勺 餐具厨具",
"pic_url": "//img1.yiwugou.com/i004/2015/05/07/98/9343a668ae15bf330593dbafbeb36f50.jpg",
"price": "1.10",
"promotion_price": "1.10",
"price_range": "",
"sales": 50,
"num_iid": "926676464",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736B",
"seller_url": "//www.yiwugo.com/hu/0435736B.html",
"seller_addr": "",
"shopid": "532506"
},
{
"title": "2号光身尖勺 430不锈钢勺 中西餐餐勺 餐具厂家直销",
"pic_url": "//img1.yiwugou.com/i004/2018/07/30/05/be97af5b501cb661e28dcd13173a4337.jpg",
"price": "1.40",
"promotion_price": "1.40",
"price_range": "",
"sales": 5,
"num_iid": "929359208",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736A",
"seller_url": "//www.yiwugo.com/hu/0435736A.html",
"seller_addr": "",
"shopid": "532501"
},
{
"title": "3号光身尖勺 430不锈钢勺 中西餐餐勺 餐具厂家直销",
"pic_url": "//img1.yiwugou.com/i004/2018/07/30/91/19497e4af8336a2c84c485a3bcf4f2b2.jpg",
"price": "1.30",
"promotion_price": "1.30",
"price_range": "",
"sales": 5,
"num_iid": "929359214",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736A",
"seller_url": "//www.yiwugo.com/hu/0435736A.html",
"seller_addr": "",
"shopid": "532501"
},
{
"title": "1号光身尖勺 430不锈钢勺 中西餐餐勺 餐具厂家直销",
"pic_url": "//img1.yiwugou.com/i004/2018/07/30/73/579afd65063edb94973e1c8bb4562828.jpg",
"price": "1.50",
"promotion_price": "1.50",
"price_range": "",
"sales": 5,
"num_iid": "929359205",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736A",
"seller_url": "//www.yiwugo.com/hu/0435736A.html",
"seller_addr": "",
"shopid": "532501"
},
{
"title": "CF111-1光身尖大勺 430不锈钢勺 中西餐餐勺 一号尖勺 厂家直销",
"pic_url": "//img1.yiwugou.com/i004/2018/11/01/20/a030ae49ced5519cd4faeb4babb61b29.jpg",
"price": "1.50",
"promotion_price": "1.50",
"price_range": "",
"sales": 5,
"num_iid": "929600565",
"sample_id": "",
"seller_nick": "中裕贸易",
"post_fee": "",
"area": "",
"seller_id": "0570281",
"seller_url": "//www.yiwugo.com/hu/0570281.html",
"seller_addr": "",
"shopid": "722410"
},
{
"title": "光身尖勺 430不锈钢勺 中西餐餐勺 餐具厂家直销五个号",
"pic_url": "//img1.yiwugou.com/i004/2018/03/19/52/05289c21cbf3f7e90559bcbcde381855.jpg",
"price": "1.20",
"promotion_price": "1.20",
"price_range": "",
"sales": 10,
"num_iid": "929115895",
"sample_id": "",
"seller_nick": "诚发餐具",
"post_fee": "",
"area": "",
"seller_id": "0435736A",
"seller_url": "//www.yiwugo.com/hu/0435736A.html",
"seller_addr": "",
"shopid": "532501"
},
{
"title": "厂家批发家用吃饭喝汤不锈钢勺子 创意多用途纯色金属调羹铂爵勺",
"pic_url": "//img1.yiwugou.com/i004/2022/07/02/05/de171183b7a67310f127a1925c64e2b2.jpg",
"price": "1.50",
"promotion_price": "1.50",
"price_range": "",
"sales": 5,
"num_iid": "941323003",
"sample_id": "",
"seller_nick": "阿白百货",
"post_fee": "",
"area": "",
"seller_id": "8880027970",
"seller_url": "//www.yiwugo.com/hu/8880027970.html",
"seller_addr": "",
"shopid": "761768"
},
{
"title": "厂家批发家用吃饭喝汤不锈钢勺子 创意多用途纯色金属调羹铂爵勺",
"pic_url": "//img1.yiwugou.com/i004/2022/06/23/35/0b66e9bb2ae51c064a4258567606e521.jpg",
"price": "1.50",
"promotion_price": "1.50",
"price_range": "",
"sales": 5,
"num_iid": "941228291",
"sample_id": "",
"seller_nick": "果然多百货商店",
"post_fee": "",
"area": "",
"seller_id": "888001220",
"seller_url": "//www.yiwugo.com/hu/888001220.html",
"seller_addr": "",
"shopid": "752014"
},
{
"title": "压蒜器家用蒜泥器捣蒜泥神器手动大蒜压蒜器夹剥蒜蓉蒜泥",
"pic_url": "//img1.yiwugou.com/i004/2020/05/26/78/3a40088c0e7296df70966563711634fe.jpg",
"price": "11.00",
"promotion_price": "11.00",
"price_range": "",
"sales": 120,
"num_iid": "931427688",
"sample_id": "",
"seller_nick": "浩隆厨具",
"post_fee": "",
"area": "",
"seller_id": "0216047A",
"seller_url": "//www.yiwugo.com/hu/0216047A.html",
"seller_addr": "",
"shopid": "539867"
},
{
"title": "亚马逊爆款IPL激光脱毛仪无痛嫩肤美容仪脱毛器剃毛器跨境直供",
"pic_url": "//img1.yiwugou.com/i004/2020/09/15/68/0c1df0f139bd6306a0bf62662e8d6a9d.jpg",
"price": "227.50",
"promotion_price": "227.50",
"price_range": "",
"sales": 2,
"num_iid": "931955618",
"sample_id": "",
"seller_nick": "",
"post_fee": "",
"area": "",
"seller_id": "",
"seller_url": "//www.yiwugo.com/hu/.html",
"seller_addr": "",
"shopid": ""
},
{
"title": "亚马逊爆款IPL激光脱毛仪无痛嫩肤美容仪脱毛器剃毛器跨境直供",
"pic_url": "//img1.yiwugou.com/i004/2020/11/08/38/73581ed58b872fdc799e56b6fde41929.jpg",
"price": "204.75",
"promotion_price": "204.75",
"price_range": "",
"sales": 2,
"num_iid": "932546147",
"sample_id": "",
"seller_nick": "锦胜外贸",
"post_fee": "",
"area": "",
"seller_id": "888007850",
"seller_url": "//www.yiwugo.com/hu/888007850.html",
"seller_addr": "",
"shopid": "749874"
},
{
"title": "五合一洁面仪 洗脸仪家用电子美容仪 电动脸部按摩器清洁去黑头",
"pic_url": "//img1.yiwugou.com/i004/2017/10/16/79/6943222449b37f1862282536f4b2e762.jpg",
"price": "7.50",
"promotion_price": "7.50",
"price_range": "",
"sales": 1000,
"num_iid": "928941574",
"sample_id": "",
"seller_nick": "金华市佰康医疗",
"post_fee": "",
"area": "",
"seller_id": "0217320B02",
"seller_url": "//www.yiwugo.com/hu/0217320B02.html",
"seller_addr": "",
"shopid": "717496"
},
{
"title": "高级不锈钢创意可爱西餐餐具套装 加厚镀金磨砂西餐刀叉勺三件套",
"pic_url": "//img1.yiwugou.com/i004/2015/07/17/25/e66cbdde671b7288db512f2e12eab956.jpg",
"price": "1.00",
"promotion_price": "1.00",
"price_range": "",
"sales": 999,
"num_iid": "926933299",
"sample_id": "",
"seller_nick": "义乌欣艺厨具",
"post_fee": "",
"area": "",
"seller_id": "0434215B01",
"seller_url": "//www.yiwugo.com/hu/0434215B01.html",
"seller_addr": "",
"shopid": "617239"
},
{
"title": "S925银情侣戒指男女士韩版简约磨砂光面绳结情侣对戒指环J3397",
"pic_url": "//img1.yiwugou.com/i004/2022/03/04/75/62ddb3f90fe79c57101304bdd5ac1c34.jpg",
"price": "20.00",
"promotion_price": "20.00",
"price_range": "",
"sales": 2,
"num_iid": "939146591",
"sample_id": "",
"seller_nick": "小胖日用百货",
"post_fee": "",
"area": "",
"seller_id": "88800799",
"seller_url": "//www.yiwugo.com/hu/88800799.html",
"seller_addr": "",
"shopid": "749937"
},
{
"title": "狗狗用品狗碗狗盆慢食碗 大型犬用宠物喂食器 狗粮桶宠物用品",
"pic_url": "//img1.yiwugou.com/i004/2020/10/24/14/d3545c15e19b38e530d7e4cdee44109d.jpg",
"price": "18.00",
"promotion_price": "18.00",
"price_range": "",
"sales": 10,
"num_iid": "932360948",
"sample_id": "",
"seller_nick": "义乌市智爱宠物用品有限公司",
"post_fee": "",
"area": "",
"seller_id": "056882401",
"seller_url": "//www.yiwugo.com/hu/056882401.html",
"seller_addr": "",
"shopid": "661582"
},
{
"title": "抖音创意透明树叶形肥皂盘浴室卫生间免打孔沥水香皂架叶子肥皂盒",
"pic_url": "//img1.yiwugou.com/i004/2022/04/25/22/edab5e4e59321efa0e91e845ed3d86d6.jpg",
"price": "7.00",
"promotion_price": "7.00",
"price_range": "",
"sales": 2,
"num_iid": "940322911",
"sample_id": "",
"seller_nick": "祥军百货",
"post_fee": "",
"area": "",
"seller_id": "888002653",
"seller_url": "//www.yiwugo.com/hu/888002653.html",
"seller_addr": "",
"shopid": "760629"
},
{
"title": "智能语音充电加热颈椎仪按摩仪脉冲微电流护颈仪理疗仪脉冲颈椎仪",
"pic_url": "//img1.yiwugou.com/i004/2021/09/14/07/0fdeb0a900c1ab8d3d3bf73f24b4fd8a.jpg",
"price": "35.28",
"promotion_price": "35.28",
"price_range": "",
"sales": 2,
"num_iid": "936500527",
"sample_id": "",
"seller_nick": "曼铺电子商务商行",
"post_fee": "",
"area": "",
"seller_id": "8880019021",
"seller_url": "//www.yiwugo.com/hu/8880019021.html",
"seller_addr": "",
"shopid": "756214"
}
]
},
"error_code": "0000",
"reason": "ok",
"secache": "b332f32265f0ff60f083c4b32e93cc83",
"secache_time": 1658801493,
"secache_date": "2022-07-26 10:11:33",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:88 max:10100 all[171=88+50+33];expires:2030-12-31",
"execution_time": "1.454",
"server_time": "Beijing/2022-07-26 10:11:33",
"client_ip": "106.6.35.233",
"call_args": {
"imgid": "http%3A%2F%2Fimg1.yiwugou.com%2Fi004%2F2018%2F03%2F19%2F19%2F3753c1a6a6452559f21f6d424b99f1f2.jpg"
},
"api_type": "yiwugo",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "3.15MB",
"request_id": "gw-3.62df4d53c8666",
"last_id": "1102950634"
}
三、错误码解释
状态代码(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 | 未知错误 | 否 |