以下是淘r宝关键词搜索商品列表数据接口的相关信息:


1.基本使用步骤:


注册登录淘r宝开放平台:你需要在淘r宝开放平台上注册成为开发者,并创建一个应用以获取 API 调用权限。


获取必要信息:获取应用的appkey(应用密钥)和appsecret(应用密钥对应的密码),以及accesstoken(访问令牌,用于验证身份和授权访问)。


调用接口:使用合适的 API 请求方式(如 HTTP GET 或 HTTP POST),调用商品搜索接口。


2.公共参数


请求地址: item_get


名称 类型 必须 描述


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版本


3.请求参数:


关键词(keyword):这是必填参数,用于指定搜索的关键词内容,通过该关键词来搜索商品列表,返回包含指定关键词的商品。


页码(page_num 或 page):指定要查询的商品列表的页码,默认为 。如果商品数量较多,需要分页查询时,可通过修改该参数获取不同页的数据。


每页数量(page_size):指定每页返回的商品数量,最大值一般为 (不同时期可能会有调整)。该参数用于控制返回结果的数量,以便根据需求获取合适的数据量。


排序方式(sort):可以根据一定的规则对商品进行排序,常见的取值有 1 - 综合排序、2 - 新品排序、3 - 销量由高到低、4 - 销量由低到高、5 - 价格由高到低、6 - 价格由低到高、7 - 信用由高到低、8 - 信用由低到高(默认为 1)。


最低价格(start_price)和最高价格(end_price):用于指定返回的商品的价格范围,与价格限定上下限成对使用。可以根据需求筛选出符合价格区间的商品。


过滤条件(filters):可填写多项,用逗号分隔。例如,1 - 免邮、2 - 天猫、3 - 全球购、4 - 消保、5 - 手机专享、6 - 淘金币、7 - 货到付款、8-7 天退换、9 - 促销等,可根据这些条件对商品进行过滤。


所在地(loc):填写省份或者城市名称,可用于筛选出特定地区的商品。


四.返回结果:


total_results:表示满足搜索条件的总商品数量。


items:具体的商品列表,包含每个商品的详细信息,如商品item_id(商品 id)、title(标题)、price(价格)、pic_url(商品图片 url)、shop_title(店铺名称)、sales(销量)、favor_count(收藏数)等。


需要注意的是,调用淘r宝开放平台的接口需要进行签名验证,确保请求的安全性和合法性。并且,淘r宝的 API 可能会根据业务需求和平台政策进行调整和更新,因此在使用时要及时关注淘r宝开放平台的官方文档获取最新的信息。