多平台根据关键词取商品列表 API 返回值说明
item_search-根据关键词取商品列表
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中)Taobao。拼多多。京东,1688API 接口测试 |
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=女装&page=&sort=
参数说明:q:关键词, 1688、淘宝、京东搜索商品聚合接口:每个平台20个数据
page:页数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
title |
String | 0 | 法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装 | 商品标题 |
num_iid |
Bigint | 0 | 577437133060 | 宝贝ID |
price |
Float | 0 | 178.00 | 价格 |
sales |
Int | 0 | 890 | 销量 |
orginal_price |
Float | 0 | 178.00 | 原价 |
promotion_price |
Float | 0 | 178.00 | 优惠价 |
pic_url |
String | 0 | //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg | 宝贝图片 |
area |
String | 0 | 山东 | 店铺所在地 |
seller_id |
String | 0 | 2217148345 | 卖家ID |
seller_nick |
String | 0 | 初穆旗舰店 | 掌柜昵称 |
detail_url |
String | 0 | //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 | 宝贝链接 |
sample_id |
Bigint | 0 | 商品风格标识ID | |
post_fee |
Float | 0 | 物流费用 | |
seller |
String | 0 | 俞兆林YZL旗舰店 | 卖家昵称 |
tag_percent |
String | 0 | 31.4% | 回头率 |
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/t1j/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&page=&sort="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
响应示例
{
"items": {
"q": "女装",
"page": 1,
"page_size": 51,
"real_total_results": 6000,
"total_results": 6000,
"pagecount": 100,
"data_from": "t1j",
"item": [
{
"item_taobao": [
{
"title": "中老年女装中长款加厚羽绒棉服女大码保暖妈妈装时尚女士棉袄冬装",
"num_iid": 591698197153,
"price": "198",
"sales": "121",
"orginal_price": "396",
"promotion_price": "198",
"pic_url": "https://img.alicdn.com/bao/uploaded/i4/2200740847519/O1CN01bETuaA25Pkf1ISgf5_!!2200740847519.jpg",
"area": "江苏 苏州",
"seller_id": 2200740847519,
"seller_nick": "康伟企业店",
"detail_url": "https://item.taobao.com/item.htm?id=591698197153"
},
{
"title": "妈妈秋装棉衣中年女羽绒棉服秋冬新款短款小棉袄中老年人女装外套",
"num_iid": 605093637186,
"price": "79.8",
"sales": "714",
"orginal_price": "208",
"promotion_price": "79.8",
"pic_url": "https://img.alicdn.com/bao/uploaded/i2/929348432/O1CN014hfZDm2C9uFz9h9Tt_!!0-item_pic.jpg",
"area": "江苏 苏州",
"seller_id": 929348432,
"seller_nick": "优姿曼旗舰店",
"detail_url": "https://detail.tmall.com/item.htm?id=605093637186"
},
{
"title": "新款中老年女装羽绒棉服中长款中年妇女加厚棉袄妈妈冬装棉衣外套",
"num_iid": 606561854030,
"price": "149",
"sales": "150",
"orginal_price": "149",
"promotion_price": "149",
"pic_url": "https://img.alicdn.com/bao/uploaded/i3/321594592/O1CN01rvmXc91jnBOEndzbi_!!321594592.jpg",
"area": "江苏 南京",
"seller_id": 321594592,
"seller_nick": "三乐sl服饰",
"detail_url": "https://item.taobao.com/item.htm?id=606561854030"
},
{
"title": "2020年冬季新款棉袄女装韩版ins面包羽绒棉服反季短款棉衣外套潮",
"num_iid": 604811256767,
"price": "178",
"sales": "234",
"orginal_price": "368",
"promotion_price": "178",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/135097900/O1CN01yrwQBW28EFU48I4uY_!!135097900.jpg",
"area": "浙江 杭州",
"seller_id": 135097900,
"seller_nick": "韩版淑女服饰",
"detail_url": "https://item.taobao.com/item.htm?id=604811256767"
},
{
"title": "