一、item_search-按关键字搜索淘宝商品接口API接入说明：
点击注册获取key和secret测试账号
二、建议使用场景
1、关键词搜索淘宝商品列表
2、获取商品详情页数据信息
3、商城系统建设
4、代购系统商城建设
5、ERP系统商品选品
三、公共参数说明：
名称 类型 必须 描述
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版本
四、API请求参数
请求参数：q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数
五、响应参数：
名称 类型 是否隐私 示例值 描述
title String 法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装 商品标题
pic_url String //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM!!0-item_pic.jpg 宝贝图片
promotion_price Float 178.00 优惠价
price Float 178.00 价格
sales Int 890 销量
num_iid Bigint 577437133060 宝贝ID
sample_id String 商品风格标识ID
seller_nick String 初穆旗舰店 掌柜昵称
post_fee Float 10.00 物流费用
area String 山东 店铺所在地
detail_url String //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 宝贝链接
seller_info Mix {“level”: 99, “shop_type”: “B”, “user_num_id”: “2217148345”, “cid”: 0, “delivery_score”: “”, “item_score”: “”, “score_p”: “”} 卖家信息
六、请求示例：（CURL、PHP 、PHPsdk 、Java 、C# 、Python)
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://api.onebound.cn/taobao/demo/sdk2020/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
API 工具
API SDK调用示例
APISDK下载
API测试工具
如何开通API测试，点击立即开通