快手根据关键词取商品列表 API 返回值说明
item_search-根据关键词取商品列表 注册开通
ks.item_search
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数
请求参数：q=衣服
参数说明：q:关键词,
响应参数
Version: Date:2023-05-29
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
|
items
|
items[] | 0 | 按关键字搜索商品 | |
|
page
|
Int | 0 | 1 | 页码 |
|
real_total_results
|
Int | 0 | 1900 | 宝贝数量 |
|
total_results
|
Int | 0 | 1900 | 宝贝数量 |
|
page_size
|
Int | 0 | 20 | 接口返回数量 |
|
pagecount
|
Int | 0 | 120 | 总页数 |
|
data_from
|
String | 0 | ||
|
item
|
item[] | 0 | 宝贝详情数据 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/ks/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=衣服"
响应示例
"item": [
{
"title": "男女同款休闲百搭【AB面 小恶魔】纯棉短袖T恤",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/item-407236546-96263f11e2cc4b228247db39d0191c77.jpg",
"promotion_price": "19.9",
"price": "19.9",
"num_iid": "4310335500546",
"seller_id": 407236546,
"shop_name": "达人丽丽教搭配个体店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=4310335500546"
},
{
"title": "高品质棉2023新款夏季男士短袖t恤韩版上衣潮流休闲纯棉半袖体恤",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-3036128838-ac48e9d3481745a4bc0f84671c96ea5e.jpg",
"promotion_price": "19.9",
"price": "19.9",
"num_iid": "20049457603838",
"seller_id": 3036128838,
"shop_name": "而潮虎门专卖店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20049457603838"
},
{
"title": "【小china】重磅纯棉短袖T恤男士夏季新款半袖上衣潮流体恤衫彩T",
"pic_url": "https://u1-203.ecukwai.com/ufile/adsocial/203aed36-0c3b-478a-8f0f-617ba1fecb5d.jpg",
"promotion_price": "19.8",
"price": "19.8",
"num_iid": "200031700580",
"seller_id": 509571580,
"shop_name": "伟足仕南宫市朋专卖店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=200031700580"
},
{
"title": "若态美式复古潮男t恤2023新款夏季白色短袖简约百搭五分袖ins港风",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-1310750239-14e420b41e3c4d2b906808b75032437a.jpg",
"promotion_price": "18.99",
"price": "18.99",
"num_iid": "20063004618239",
"seller_id": 1310750239,
"shop_name": "若态鞋靴旗舰店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20063004618239"
},
{
"title": "夏季冰丝t恤男圆领速干衣短袖薄款透气半袖大码上衣男运动宽松潮",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/item-464975201-c1ca097d86634cf1917fd3e3d7b80344.jpg",
"promotion_price": "19.9",
"price": "19.9",
"num_iid": "4375767480201",
"seller_id": 464975201,
"shop_name": "胖嘟嘟潮童一号店个人店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=4375767480201"
},
{
"title": "夏季纯棉短袖男士t恤2023新款半袖男生上衣潮流全棉体恤衫男装",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/item-509571580-f72337c541e24652b1d01779e5a5f28b.jpg",
"promotion_price": "19.8",
"price": "19.8",
"num_iid": "1370998092580",
"seller_id": 509571580,
"shop_name": "伟足仕南宫市朋专卖店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=1370998092580"
},
{
"title": "冰丝短袖t恤男士夏季宽松大码男装休闲百搭体恤衫韩版潮流衣服男T",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/9793074d-df89-414d-84ff-9c7a454c9af7-i1657555655137.jpg",
"promotion_price": "38.9",
"price": "38.9",
"num_iid": "4679125958756",
"seller_id": 1851271756,
"shop_name": "小萧工厂个体店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=4679125958756"
},
{
"title": "短袖t恤男夏季ins韩版宽松男士半袖男体恤上衣2023新款潮流T恤衫",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/item-2923325328-90c85e0ecfba44208a123812183ecafe.jpg",
"promotion_price": "15.9",
"price": "15.9",
"num_iid": "20204628342328",
"seller_id": 2923325328,
"shop_name": "棉小仔工厂店个体店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20204628342328"
},
{
"title": "夏季洋气纯棉短袖 男女同款T恤-BOBU熊",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2258939776-55a34afc4a3d423e8abc9b42f6396b3b.jpg",
"promotion_price": "16.9",
"price": "16.9",
"num_iid": "20004949183776",
"seller_id": 2258939776,
"shop_name": "静水服装店个体店",
"detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20004949183776"
},
{
"title": "567【厂家直发】冰丝男士短袖t恤透气潮流",
"pic_url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-1462676857-ed3b66c482d04f1b978a342b812b9cfd.jpg",
"promotion_price": "18.8",
"price": "18.8",
"num_iid": "20277721274857",
"seller_id": 1462676857,
"shop_name": "闲生的小店个体店","detail_url":"https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20277721274857"}]},"error":"","translate_status":"","translate_time":0,"language":{"default_lang":"cn","current_lang":"cn"},"reason":"","error_code":"0000","cache":0,"api_info":"today:5 max:30000 all[7=5+0+2];expires:2024-05-20","execution_time":"0.579","server_time":"Beijing/2023-05-29 11:21:26","client_ip":"106.6.37.94","call_args":{"num_iid":"20046611202546"},"api_type":"ks","translate_language":"zh-CN","translate_engine":"baidu","server_memory":"3.08MB","request_id":"1.64741a35a4d99","last_id":"1770033004"}
异常示例
{
"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": "ks",
"request_id": "20046611202546"}
相关资料
错误码解释
| 状态代码(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 | 未知错误 | 否 |
快手根据关键词取商品列表 API 返回值说明的更多相关文章
- Python post请求模拟登录淘宝并爬取商品列表
一.前言 大概是一个月前就开始做淘宝的爬虫了,从最开始的用selenium用户配置到selenium模拟登录,再到这次的post请求模拟登录.一共是三篇博客,记录了我爬取淘宝网的经历.期间也有朋友向我 ...
- java~api返回值的标准化
api返回值的标准化 例如 {"status":200,"message":"操作成功","data":"{\ ...
- Web Api返回值
首先:注明,我还没这么强的功力啦!这是我看的网上的,因为怕博主删除就自己复制了一下 博主的网址是:http://www.cnblogs.com/landeanfen/p/5501487.html 使用 ...
- Restful api 返回值重复的问题
Spring boot全家桶前后端分离的项目,在扩充某一个列表形式的返回值时,发现返回值出现了一批的重复. 正常的数据返回: 数值完全一致只是参数名称区分了大小写,如下图: 推测可能是restful格 ...
- C# 通过反射获取MVC Controller里的类名，方法名，参数列表，返回值类型，Description描述，自定义Attribute
需要反射的DLL里的一个类: namespace ElegantWM.WebUI.Areas.Admin.Controllers { [Description("功能模块管理")] ...
- 只需一步，在Spring Boot中统一Restful API返回值格式与统一处理异常
## 统一返回值 在前后端分离大行其道的今天,有一个统一的返回值格式不仅能使我们的接口看起来更漂亮,而且还可以使前端可以统一处理很多东西,避免很多问题的产生. 比较通用的返回值格式如下: ```jav ...
- Asp.net Core 异常日志与API返回值处理
需求: 1.对异常进行捕获记录日志 并且修改返回值给前端 解释: ILogger4是自定义的一个日志,更改它就好 解决方案1: 使用中间件进行异常捕获并且修改其返回值 public class Err ...
- 淘宝/天猫获得淘宝商品评论 API 返回值说明
item_review-获得淘宝商品评论 taobao.item_review 公共参数 API测试工具 名称 类型 必须 描述 key String 是 调用key(必须以GET方式拼接在URL中) ...
- 【Spring Boot-技巧】API返回值去除为NULL的字段
简介 在前后端分离的微服务时代,后端API需要良好的规范.本篇主要将一个数据返回时的一个小技巧-- 过滤为空字段 解决痛点:将有效解决数据传输过程中的流量浪费. 组件简介 Jackson Object ...
- 获取API返回值
//$return=getApiResult($url); // if ($return==200){ // //..... // } function getApiResult($url){ if( ...
随机推荐
- XAF Excel Importer
开源项目地址:https://gitee.com/easyxaf/excel-importer 前言 在XAF中有Excel导出,但没有Excel导入,一开始不理解,难道Excel导入很难实现吗,当我 ...
- Ubuntu 18.04 (Bionic) 简单快速的安装mongodb
按步骤走,不带脑子式安装(注意4.0版本mongodb官方已经不再支持,以下代码中可以修改mongodb版本号安装,目前最新版为6.0,如果懒得改直接用也可以,文章后边第三章第一条代码会直接升级为最新 ...
- 【密码学】为什么不推荐在对称加密中使用CBC工作模式
引言 这篇文章是我在公司内部分享中一部分内容的详细版本,如标题所言,我会通过文字.代码示例.带你完整的搞懂为什么我们不建议你使用cbc加密模式,用了会导致什么安全问题,即使一定要用需要注意哪些方面的内 ...
- Nodejs 应用编译构建提速建议
编译构建的整体过程 拉取编译镜像 拉取缓存镜像 拉取项目源码 挂载缓存目录 执行编译命令(用户自定义) 持久化缓存 上传编译镜像 为什么在本地构建就快, 但编译机上很慢 在编辑机上每次的构建环境都是全 ...
- odoo开发教程十二：web controlle
一:路由 odoo.http.route(route=None, **kw) 装饰器可以将对应方法装饰为处理对应的http请求,该方法须是Controller的子类. route -- 字符串或数组, ...
- 【Haxe】（二）字符串与变量的输入输出
前言 每次学习一门新语言,各种手册和教程一上来就是讲变量如何定义,数据结构怎么用,很少有讲输入输出应该怎么写的.我比较喜欢先搞懂这部分,这让我感觉像是掌握了学习主动权,很能调动我的学习积极性.于是我的 ...
- 利用APIFOX对ABAP函数进行调用
1.安装APIFOX,当然也可以使用在线版,无需下载 官网地址:https://apifox.com/ 2.新建项目 3.为项目起一个名称,为相关开发测试人员授权 4.在根目录新增子目录 5.编辑开发 ...
- 2023-06-02：给定一个二进制数组 nums 和一个整数 k， k位翻转 就是从 nums 中选择一个长度为 k 的 子数组， 同时把子数组中的每一个 0 都改成 1 ，把子数组中的每一个 1
2023-06-02:给定一个二进制数组 nums 和一个整数 k, k位翻转 就是从 nums 中选择一个长度为 k 的 子数组, 同时把子数组中的每一个 0 都改成 1 ,把子数组中的每一个 1 ...
- 关于Abp Vnext 权限授权的问题
一.问题 最近收到一位朋友的求助,说他项目上的权限授权出现了问题,现象是在基础服务授权角色:RC 权限:X.Default,在基础服务使用RC角色的用户登录能访问到权限X.Default资源,而在X服 ...
- 跑得更快！华为云GaussDB以出色的性能守护“ERP的心脏”
摘要:GaussDB已经全面支撑起MetaERP,在包括库存服务在内的9大核心模块中稳定运行,端到端业务效率得到10倍提升. 本文分享自华为云社区<跑得更快!华为云GaussDB以出色的性能守护 ...