搜索产品信息
支持平台： 淘宝, 拍拍
搜索产品信息
支持平台： 淘宝, 拍拍
需授权
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称 |
| certi_id | Number | 否 | 分配给应用的证书ID |
| from_node_id | String | 是 | API调用的来源节点ID,对于第三方开发者来说，此id即为申请应用颁发的APP KEY |
| from_api_v | String | 否 | 请求方版本号 |
| to_node_id | String | 否 | API调用的目的节点ID(除了基础服务类api，其他接口必传此参数) |
| to_api_v | String | 否 | 接收方版本号 |
| callback_url | String | 否 | 响应回调地址，带http路径的标准URL。（调用异步接口此参数必填） |
| v | String | 是 | 矩阵API协议版本，可选值:1.0 |
| timestamp | String | 是 | 时间戳，格式为yyyy-MM-dd hh:mm:ss，例如：2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟 |
| format | String | 是 | 可选，指定响应格式。默认JSON ,目前支持格式为JSON |
| sign | String | 是 | 对调用API时所有输入参数（包括应用级参数）进行签名结果 |
| 名称 | 类型 |
|
示例值 | 默认值 | 描述 |
|---|---|---|---|---|---|
| q | String |
淘宝(必填) 拍拍(必填) |
搜索的关键词是用来搜索产品的title以及关键属性值的名称.如:"优衣库 1234",这种用来表示查询优衣库这个品牌下的货号为1234的产品; 注:q,cid和props至少传入一个 |
||
| cid | String |
淘宝(必填) 拍拍(必填) |
商品类目ID. |
||
| props | String |
淘宝(必填) 拍拍(必填) |
属性,属性值的组合.格式:pid:vid;pid:vid; |
||
| status | String |
淘宝(可选) 拍拍(必填) |
想要获取的产品的状态列表，支持多个状态并列获取，多个状态之间用","分隔，最多同时指定5种状态。例如，只获取小二确认的spu传入"3",只要商家确认的传入"0"，既要小二确认又要商家确认的传入"0,3"。目前只支持者两种类型的状态搜索，输入其他状态无效。 |
||
| page_no | Number |
淘宝(必填) 拍拍(必填) |
页码.传入值为1代表第一页,传入值为2代表第二页,依此类推.默认返回的数据是从第一页开始. |
||
| page_size | Number |
淘宝(可选) 拍拍(可选) |
每页条数.每页返回最多返回100条,默认值为40 |
||
| vertical_market | String |
淘宝(可选) 拍拍(可选) |
传入值为：3表示3C表示3C垂直市场产品，4表示鞋城垂直市场产品，8表示网游垂直市场产品。一次只能指定一种垂直市场类型 |
| 名称 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| products | Product | 是 | 返回product_id,outer_id,created |
{
"rsp":"succ",
"msg_id":3463421b2581604c74dcb9b74ffab2e4,
"data":{
"products":{
"product_id": 3433222,
"outer_id": "123456",
"created": "2000-01-01 00:00:00"
}
}
}
| 错误码 | 错误描述 | 解决方案 |
|---|
