阿里妈妈按关键字或网址搜索商品 API 返回值说明item_search-按关键字或网址搜索商品 API测试工具 a

item_search-按关键字或网址搜索商品 API测试工具

alimama.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=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字，支持url
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_credit,_income,_prom,_comm]
(bid:总价,sale:销量,credit信用/人气,income收入，月推广量,comm月支出佣金。加_前缀为从大到小排序)
page:
seller_info:不支持
nick:不支持
ppath:不支持
imgid:不支持
filter:参数数组:(以:分隔键和值，以;分隔参数组,支持的参数如下：
startTkRate:0,收入比率大于
endTkRate:100,收入比率少于
b2c:1,天猫
startBiz30day:10,月销量
hPayRate30:1,月成交转化率高于行业均值
freeShipment:1,包邮
dpyhq:1,店铺优惠券
yxjh:1,营销和定向计划
loc:北京,发货地)

响应参数 Version: Date:

名称	类型	示例值	描述
items	items[]		按关键字或网址搜索商品
title	String	短袖女装2019新款夏纯棉面料宽松潮印花t恤白色学生上衣定制covea	商品标题
num_iid	Bigint	586359092786	商品ID
price	Int	169	价格
sales	Int	1557	销量
orginal_price	Float	49.9	原价
promotion_price	Float	49.9	优惠价
pic_url	String	//img.alicdn.com/bao/uploaded/i4/2139349365/O1CN01UjNbFz2J3DeQhyw5u_!!2-item_pic.png	商品图片
detail_url	String	item.taobao.com/item.htm?id…	商品链接
commission_rate	Int	2066
coupon_start_time	Date	2019-03-20	优惠开始时间
coupon_end_time	Date	2019-03-25	优惠结束时间
coupon_info	String	满49元减20元	优惠信息
provcity	String	浙江嘉兴	地区
seller_id	Bigint	2139349365	卖家ID
seller_nick	String	covea旗舰店	卖家昵称
shop_title	String	covea旗舰店	店铺标题
images	Max	{"img.alicdn.com/i2/22066448…	图片

请求示例（PHP）

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://o0b.cn/jennif
$method = "GET";
$url = "https://服务器地址/alimama/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));
?>
```
```