快手根据关键词取商品列表 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( ...
随机推荐
- hvv蓝初面试常见漏洞问题（下）
hvv蓝初面试常见漏洞问题(上) 6.ssrf 服务端伪造请求 原理 服务端提供了向其他服务器应用获取数据的功能,而没有对目标地址做任何过滤和限制.攻击者进而利用其对内部资源进行攻击.(通俗来说:就是 ...
- 如何用ReadWriteLock实现一个通用的缓存中心？
摘要:在并发场景中,Java SDK中提供了ReadWriteLock来满足读多写少的场景. 本文分享自华为云社区<[高并发]基于ReadWriteLock开了个一款高性能缓存>,作者:冰 ...
- Bio+IT 爱好者社区，欢迎你！
生物信息学是一个跨学科的大领域,一直以来,做生物信息分析的工程师都需要跟 IT 打交道. 现实问题是,有很多生物学.医学.遗传学背景的 Bio 人对生物领域拥有非常专业的知识经验,而对 IT 领域知之 ...
- Kali安装GVM
1.安装gvm ┌──(rootkali)-[/home/kali] └─# gvm-setup 1 ⨯ [>] Starting PostgreSQL service [-] ERROR: T ...
- 在Istio中，到底怎么获取 Envoy 访问日志？
Envoy 访问日志记录了通过 Envoy 进行请求 / 响应交互的相关记录,可以方便地了解具体通信过程和调试定位问题. 环境准备 部署 httpbin 服务: kubectl apply -f sa ...
- 重新搞懂Git，掌握日常命令和基本操作
1.git Git 是一个免费的开源分布式版本控制系统,旨在快速高效地处理从小型到超大型项目的所有内容. Git 易于学习,占用空间很小,性能快如闪电.它超越了Subversion,CVS,Perfo ...
- NextJS项目的部署以及多环境的实现
背景 开发了个Next项目,将部署过程记录一下.另外由于项目准备了两个服务器分别作为开发自测的开发环境和交付给客户的生产环境使用:因此也介绍一下NextJS项目中多环境的配置. 项目结构 计划是让Ng ...
- 行行AI人才直播第6期：当AIGC时代降临，当代青年如何把握新时代机遇
AIGC时代的到来,给我们带来了无限的想象空间和创造力.AIGC不仅可以提高内容生产的效率和质量,还可以创造出人类无法想象的新颖和有价值的内容,为数字文化产业.产业互联网.社会价值等领域带来变革性的影 ...
- Task Execution and Scheduling In SpringBoot
开天辟地 Task Execution and Scheduling In the absence of an Executor bean in the context, Spring Boot au ...
- 华为云河图KooMap 共筑数字孪生底座 共建产业标杆
摘译:7月7日至9日,华为开发者大会2023(Cloud)将在东莞溪村盛大举行,由华为云河图KooMap带来的关于数字孪生主题的技术分论坛.圆桌闭门会和精彩成果展示 7月7日至9日,华为开发者大会20 ...