1、搜索模式API使用说明
API调用地址:
http://sapi.manmanbuy.com/Search.aspx?AppKey=申请appkey&Key=搜索关键词&Class=分类ID&Brand=品牌ID&Site=商城ID&PriceMin=最低价&PriceMax=最高价&PageNum=页号&PageSize=每页商品数&OrderBy=排序方式&ZiYing=是否自营&ExtraParameter=扩展参数
参数说明:
参数名
类型
说明
AppKey
string
访问验证,AppKey需申请
Key
string
要比价的搜索关键词
特别说明:由于我们的接口编码是GB2312的, 对传入的Key需要gb2312编码,c#代码如下:
HttpUtility.UrlEncode(key,Encoding.GetEncoding("GB2312"))
Class
string
分类编号,如果不对分类做筛选,则该值为“0”
Brand
string
品牌编号,如果不对品牌进行筛选,则该值为“0”
Site
string
商城编号,如果不对商城做筛选,则该值为“0”
PriceMin
int
价格区间中的最低价格。为0表示没有最低价格
PriceMax
int
价格区间中的最高价格。为0表示没有最高价格
PageNum
int
页号,需要大于0
PageSize
int
每页要显示的商品数,最大限制为80
OrderBy
string
排序方式
1、score 按权重从高到底排序,默认
2、price 按价格从底到高排序
3、sell 按评论从高到底排序
4、price2 按价格从高到低排序
ZiYing
bool
ZiYing=true 只选自营
ZiYing=false 都包含
zyStatus
int
ZiYing=false&zyStatus=1 ziying=false或者不传 zyStatus=1 只选旗舰店
ZiYing=false&zyStatus=2 ziying=false或者不传 zyStatus=2 自营+旗舰店
ZiYing=false&zyStatus=3 ziying=false或者不传 zyStatus=3 只选非自营
调用示例
<http://sapi.manmanbuy.com/Search.aspx?AppKey=123456&Key=iphone&Class=0&Brand=0&Site=0&PriceMin=0&PriceMax=0&PageNum=1&PageSize=30&OrderBy=score&ZiYing=false&ExtraParameter=0>
示例说明
AppKey是:123456(需要申请的),搜索词是:iphone,并且不对分类,品牌,商城做过滤,并且不设置最低价格,也不设置最高价格,搜索的页号为第1页,每页显示30条记录,排序方式是按照权重排序,搜索结果不排除第三方,同时结果包含淘宝数据。
返回格式说明(json)
返回类型采用json的方式,方便传输及解析 返回的Json结果中有以下字段:
参数名
类型
说明
State
int
反馈的状态,共有3种状态
1000:表示成功;
1001:表示传递的参数错误;
1002:表示没有权限;
1003:表示访问频度过高;
1004:表示品牌编号错误。
-1000:获取数据超时。
SearchItemsCount
int
返回的记录总数
SearchCount
int
返回的本次实际数量
ClassList
string
返回的搜索结果分组
这个分组是指商品分类的分组,比如搜索iphone会返回手机分类和配件分类各有多少商品数量
多个分类之间用“,”分隔。
内容示例: 57|1074|手机,893|29964|iPhone 配件,892|19512|手机保护套,910|11169|苹果配件
第一部分内容的详细说明:57|1130|手机
57是分类ID(只想查看这个分类下的商品时,分类ID可以作为参数传递给接口);1130是商品数量;手机是分类名称
BrandList
string
搜索结果品牌的分组,多个品牌用“,”分隔,含义同ClassList。
每个品牌由3部分组成,比如:16036|955|小米
对应:品牌ID|商品数量|品牌名称
16036是品牌ID;955是商品数量;小米是品牌名称。
SiteList
string
搜索结果商城的分组,多个商城用“,”分隔。
每个商城由3部分组成,比如:1|8861|京东商城
对应:商城ID|商品数量|商城名称
1是商城ID;8861是商品数量;京东商城是商城名称。
SearchResultList
json
搜索结果json串,这个字符串包含了返回的商品信息,详细说明请参照后面的表格
SearchResultList的json说明,该json包含了返回的所有商品信息,每个商品信息的字段如下:
参数名
类型
说明
id
int
该商品报价的ID,唯一
spname
string
商品名称
spurl
string
商品URL地址
sppic
string
商品图片url
spprice
string
商品价格
className
string
分类名称
brandName
string
品牌名称
siteName
string
商城名称
siteid
int
商城ID
commentUrl
string
评论地址
commentCount
int
评论数量
TitleHighLighter
string
高亮标题,会对搜索词进行加红
ziying
int
是否自营,1表示自营,2表示第三方,4表示旗舰店
spbh
string
商品编号
classid
string
分类id
shopName
string
店铺名称
monthComment
int
月评论量
date2
datetime
暂时无效
返回结果示例(以“TCL空气净化器”为例,显示前2条商品信息):
{ "State": 1000, "SearchItemsCount": 3, "SearchCount": 3, "ClassList": "1713|1|生活电器配件,18|1|空气净化器,993|1|家电配件", "BrandList": "", "SiteList": "10|1|天猫商城,1|1|京东商城,6|1|苏宁易购", "SearchResultList": \[{ "spname": "适配TCL空气净化器过滤网TKJ303F-C1 TKJ308F-A1滤芯复合集尘hepa", "sppic": "http://img.alicdn.com/imgextra/i3/2204165973941/O1CN01gyrKlI1ez1S8CvFds\_!!2204165973941.jpg", "spurl": "https://detail.tmall.com/item.htm?id=598871521343", "spprice": "125.00", "className": "生活电器配件", "brandName": "", "siteName": "天猫商城(郁琥旗舰店)", "commentUrl": "", "commentCount": "9", "TitleHighLighter": "适配TCL空气净化器过滤网TKJ303F-C1 TKJ308F-A1滤芯复合集尘hepa", "ziying": "4", "taobaoid": null, "siteid": "10", "id": "2161020285", "classid": "1713", "spbh": "10|598871521343", "date2": "0001/1/1 0:00:00", "monthComment": 2, "shopName": "郁琥旗舰店" }, { "spname": "TCL空气净化器TCL TKJ303F-C1智能变档 自动净化强化除醛家用除甲醛卧室室内负离子氧吧除雾霾除尘烟PM2.5", "sppic": "https://imgservice5.suning.cn/uimg1/b2c/image/6CacL7ePf5agc0KLv8ZWyQ.jpg\_400w\_400h\_4e", "spurl": "https://product.suning.com/0070179603/11355140639.html", "spprice": "899.00", "className": "空气净化器", "brandName": "TCL", "siteName": "苏宁易购(爱优品专营店)", "commentUrl": "", "commentCount": "46", "TitleHighLighter": "TCL空气净化器TCL TKJ303F-C1智能变档 自动净化强化除醛家用除甲醛卧室室内负离子氧吧除雾霾除尘烟PM2.5", "ziying": "2", "taobaoid": null, "siteid": "6", "id": "2032737769", "classid": "18", "spbh": "6|0070179603\_11355140639", "date2": "0001/1/1 0:00:00", "monthComment": 0, "shopName": "爱优品专营店" }, { "spname": "车彩适配TCL空气净化器滤芯过滤网 TKJ303F-C1", "sppic": "http://img13.360buyimg.com/n7/jfs/t1/108529/38/12032/125196/5e9071f5Ec39cb621/5097790d10b73de3.jpg", "spurl": "https://item.jd.com/67846434388.html", "spprice": "227.00", "className": "家电配件", "brandName": "", "siteName": "京东商城(车彩电器专营店)", "commentUrl": "", "commentCount": "14", "TitleHighLighter": "车彩适配TCL空气净化器滤芯过滤网 TKJ303F-C1", "ziying": "2", "taobaoid": null, "siteid": "1", "id": "2332918727", "classid": "993", "spbh": "1|67846434388", "date2": "0001/1/1 0:00:00", "monthComment": 0, "shopName": "车彩电器专营店" }\] }
接口1包含的商品数据
综合商城:京东、苏宁、国美、天猫旗舰店(部分品牌)、中国亚马逊、网易考拉、当当、唯品会、小红书、新蛋网...
品牌官网:小米官方商城、海尔官方商城、华为官方商城、网易严选、小米有品、联想商城...
办公相关:得力、晨光科力普、史泰博、西域、物产商城、 领先未来、办公伙伴...
注:如要增加天猫商品请跟商务对接,以上商品数据不包含图书、药品。
辅助API、获取商城ID和商城名称对应API
辅助API,只配合接口1(搜索API)使用,可根据商城ID显示商城名称。
调用方式: http://sapi.manmanbuy.com/SiteList.aspx?AppKey=你的appkey&SiteId=0
辅助API、根据商品ID获取商品信息
辅助API2,只配合接口1(搜索API)使用,可根据商品ID显示商品信息。
调用方式: http://sapi.manmanbuy.com/Search\_GetPrice.aspx?Ids=2283853847,2339665634&AppKey=你的appkey