详细描述

搜索产品信息

支持平台: 淘宝, 拍拍

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
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

XML数据格式:

			
JSON数据格式:
{
   "rsp":"succ",
   "msg_id":3463421b2581604c74dcb9b74ffab2e4,
   "data":{
       "products":{
            "product_id": 3433222,
            "outer_id": "123456",
            "created": "2000-01-01 00:00:00"
      }
   }
}

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2012-06-07 17:50:51