快手根据关键词取商品列表 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( ...
随机推荐
- Serverless冷扩机器在压测中被击穿问题
一.现象回顾 在今天ForceBot全链路压测中,有位同事负责的服务做Serverless扩容(负载达到50%之后自动扩容并上线接入流量)中,发现新扩容的机器被击穿,监控如下(关注2:40-3:15时 ...
- OneForAll下载安装以及环境配置
python-3.9.7-amd64 OneForAll-master python安装以及插件安装 首先下载python解压到电脑c盘在c盘中创建一个工具文件夹,然后下载OneForAll-mast ...
- 聊聊Spring Cloud Gateway
网关概述 整体来看,网关有点类似于门面,所有的外部请求都会先经过网关这一层. 网关不仅只是做一个请求的转发及服务的整合,有了网关这个统一的入口之后,它还能提供以下功能. 针对所有请求进行统一鉴权.限流 ...
- Redis系列14：使用List实现消息队列
Redis系列1:深刻理解高性能Redis的本质 Redis系列2:数据持久化提高可用性 Redis系列3:高可用之主从架构 Redis系列4:高可用之Sentinel(哨兵模式) Redis系列5: ...
- 在DevExpress的GridView的列中，使用RepositoryItemSearchLookUpEdit控件实现产品列表信息的展示和选择
有时候,我们为了方便,我们往往使用扩展函数的代码方式创建很多GridView的操作功能,如在随笔<在DevExpress中使用BandedGridView表格实现多行表头的处理>中介绍过多 ...
- Linq的所有用法(简单化)
Linq 是一种强大的查询语言,可以过滤.排序和组合各种数据源.下面我们将讨论 Linq 的各种用法. Linq 的基本语法: Linq 可以应用于任何对象集合,以下是一个示例: var number ...
- 【技术积累】Linux中的基础知识【二】
Linux的发行版本 Linux是一个开源操作系统,有许多发行版,每个发行版都有自己的特点和优势.以下是一些常见的Linux发行版: Ubuntu:Ubuntu是最受欢迎的Linux发行版之一,它拥有 ...
- win10系统网络图标变成一个地球模型并且无法连上网络
最近在家远程办公,但是遇到个很棘手的问题,电脑突然连不上无线网络了.... 无线网络图标变成地球模型如下:
- TCP和UDP的应用场景
传输层的两个协议,TCP(Transmission Control Protocol,传输控制协议)和UDP(User Datagram Protocol,用户数据报协议),有各自的应用场景. TCP ...
- Mysql基础6-常用数据库函数
一.字符串函数 1.常见Mysql内置字符串函数 concat(s1,s2,s3,...):字符串拼接,将s1,s2,s3...等拼接成一个字符串 lower(str):将字符串str全部转为小写 u ...