团购网站导航

2345团购导航合作api操作手册

上海瑞创-产品中心三部第1页共12页整理人：王远成

2345团购导航合作api手册v4.0

一、API正文

字体蓝色为注释性语句，红色为注意事项。<申明：API4.0格式不是xml形式或html形式的,所以抓取方式是逐行读取数据内容而不是根据

xml的节点或其他方式。因此请开发时千万别走入误区。API格式如下：>

API正文如下注释

ver=4.0

商品URL

网站名称

城市

一级分类

商品标题

商品图片地址

商品开始时间

第1行:API的版本号，必须放在第一行

第2行:起始分隔符

第3行:varchar(255),网站地址*必填。原API2.0标签。

第4行:varchar(100),网站名称*必填。原API2.0标签。

第5行:varchar(100),城市名称*必填。原API2.0标签。

第6行:分类类别*必填。只能从下列分类中选择一个：餐饮美食/生活娱乐/网上购物/旅游酒店/化妆品。原API2.0标签。

第7行:varchar(255),商品的标题*必填。原API2.0标签。

第8行:varchar(255),商品图片链接地址*必填，必须以http://开头.扩展名必须为jpg,gif或png。原API2.0标签。

第9行:int(11),团购开始时间*必填，指时间戳时间,必须是10位的数字。原API2.0标签。

2345团购导航合作api操作手册

上海瑞创-产品中心三部第2页共12页整理人：王远成

商品结束时间

商品原价

商品现价

折扣

购买人数

消费开始时间

消费结束时间

收藏人数

商品描述

商品提示

底层分类

第10行:int(11),团购结束时间*必填，指时间戳时间,必须是10位的数字。原API2.0标签。

第11行:decimal(15,2),原价*必填，必须为数字可以带小数点。原API2.0标签。

第12行:decimal(15,2),团购价*必填，必须为数字可以带小数点。原API2.0标签。

第13行:varchar(50),折扣*必填，数字可带小数点，小数点保留2位，第三位向第二位四舍五入若无填0。原API2.0标签。

第14行:int(11),购买人数*必填，必须为0或正整数。原API2.0标签。

第15行:int(11),消费开始时间*必填，必须是10位的数字。原API2.0标签。

第16行:int(11),消费结束时间*必填，必须是10位的数字，若无可以填0。原API2.0标签。

第17行:空行

第18行:空行

第19行:int(11),收藏人数*必填，必须为0或正整数。原API2.0标签。

第20行:空行

第21行:varchar(255),商品描述选填，纯文字不超过255个字。商品的具体形态，非商品标题。比如衣服款式尺寸。

第22行:varchar(255),商品提示信息选填，纯文字不超过255个字。消费截止时间，消费特别提醒等商家重要信息。

第23行:varchar(120),底层分类,即在贵站中的最后一级别分类，如有三级分类请填写三级分类，如没有请填二级分类。

2345团购导航合作api操作手册

上海瑞创-产品中心三部第3页共12页整理人：王远成

商户详细地址

商户缩略地址

商户电话

公交信息

商家名称

大众点评网ID

九寨沟

化妆品品牌

化妆品功效

第24行:varchar(60),目前已经采用程序自动判别地址归商圈,填空

第25行:varchar(255),详细地图地址*必填。省略”省，城市，区”只填写街道，门牌号后的数字。若城市为“全国”这里请留空。

第26行:varchar(100),简短地图地址*与上一行填写同样内容,若城市为“全国”这里请留空。原API2.0标签.

第27行:varchar(60),商店地址的联系电话*选填。原API2.0标签.

第28行:varchar(60),公交线路*选填，用于后期开发公交沿线搜索。原API2.0标签.

第29行:varchar(120),原API2.0标签

第30行:varchar(120),商家名称，非必填字段没有请留空。原API3.0标签

第31行:int(11),该商品的大众点评网ID，非必填字段没有则填0。原API3.0标签

第32行:varchar(120),旅游目的地。非必填字段新API4.0标签

第33行:varchar(120),化妆品品牌。非必填字段新API4.0标签

第33行:varchar(120),化妆品功效。非必填字段新API4.0标签

第35行:varchar(255),商品的备注字段3*留空。以后扩充功能使用。原API2.0标签

第36行:varchar(255),地图的备注字段3*留空。以后扩充功能使用。原API2.0标签

第37行:结束符

2345团购导航合作api操作手册

上海瑞创-产品中心三部第4页共12页整理人：王远成

二、API举例

范例说明：

ver=4.0

X团

上海

餐饮美食

仅售36.9元!英国女王、戴安娜王妃最爱:原价85元皇家御用CYCLAX绿茶面颈滋润霜!神奇抹去颈部细纹,网上超爆人气,狂卖

/static/team/2010/0830/

1299551333

1299551333

150.00

50.00

3.0

2345团购导航合作api操作手册

上海瑞创-产品中心三部第5页共12页整理人：王远成

222

1299551333

1299551333

200

商品描述

商品提示

六一

淮海路

北京西路235弄38号广汇广场

北京西路235弄38号广汇广场

1-435833

2345团购导航合作api操作手册

上海瑞创-产品中心三部第6页共12页整理人：王远成

2345团购导航合作api操作手册

上海瑞创-产品中心三部第7页共12页整理人：王远成

三、各字段名说明

字段名字段说明属性限制必填项

商品url描述详细信息页面的ULR地址（新增商品的url不要覆盖老的商品的url）URL256B是

站点名称站点名称文本50B是

城市

城市名称（城市名称不需要附带省、市、区、县等字，如果是全国范围请指明：全

国）注意：只能填写一个城市名称

文本16B是

一级分类分为“餐饮美食”“生活休闲”“旅游酒店”“网络购物”“化妆品”文本2B是

细分类

指团购商品一级类目对应的二级类目。注意：每个商品只有一个细分类，具体参见

API分类说明

文本16B是

商家的大众点评网ID团购商家的大众点评shopid，文本512B否

商圈名称团购商家的大概方位文本512B否

商家的详细地址团购商家的具体位置，多个以英文逗号分隔，按照填写顺序显示商家文本512B否（本地类必填）

是否主打可填写1或者0,1为主打，0为非主打文本2B是

商品标题商品标题（如：原价188元的"玛雅蛋糕"仅售49元！）文本512B是

商品图片地址商品图片url。图片大小宽*高为266*166,图片大小要小于15KURL256B是

开始时间团购商品开始时间。（如：1275926400）文本10B是

结束时间团购商品结束时间。（如：1291910399）文本10B是

消费开始时间消费商品开始时间。（如：1275926400）文本10B是

消费结束时间消费商品结束时间。（如：1291910399）文本10B是

商品原价商品原价文本12B是

现价商品现价文本12B是

折扣商品折扣文本6B是

购买人数已购买人数文本10B是

商品描述商品名称准确描述，如"铅笔盒"文本512B否（网购类必填）

消费提示商家的消费提示文本512B否

2345团购导航合作api操作手册

上海瑞创-产品中心三部第8页共12页整理人：王远成

商家名称商家的准确描述，如"青鸟健身"、"必胜客"文本512B否（本地类必填）

商家电话商家的电话号码，多个号码文本50B否

商家公交信息商家的公交信息文本50B否

收藏人数收藏人数多少文本50B是

三级分类商品的三级分类，请参见文档附表文本50B否

商户详细地址填写商户详细地址文本512B否

商户缩略地址填写商户缩略地址文本512B否

四、API分类说明

一级分类备注

1.所有需要到店消费的餐饮类商品，均可列入此类；

2.需到门店自提或本地包邮的食品例如蛋糕等，也可以归入此分类；

3.其他网购类零食商品，均不属于此分类。

生活娱乐1.如单店经营项目包含KTV、台球、畅饮、桌游等，属于桌游吧，归于游乐电玩分类。

1.此分类下均为邮购商品；

2.鲜花、图书等商品可提交至本分类中的“其他”分类下；

旅游酒店所有旅游类，酒店类均属于此类，包含景点通票

化妆品所有化妆品类商品均属于此类商品

API分类说明

餐饮美食

网上购物

2345团购导航合作api操作手册

上海瑞创-产品中心三部第9页共12页整理人：王远成

五、API制作注意事项

1、每个产品由开始结束，其中间包含36个字段信息，每个字段信息一行，所以每个产品中间务必只有36行，每行内容最后请用回车换

行符("rn")结束，每行数据的内容中如果有回车换行符("rn"、"r"、"n")请替换成字符串"
"。

2、所有非数字选填项没有则为空，数字的选填项没有则填0

3、请在文件开头加上ver=版本号（目前为4.0）,不加版本号的API将视为无效API。

4、严格按照标准制作可以帮助您更好更快的抓取商品,所以请严格对照标准来制作api,认真填写每一行数据.由于导航站每日编辑处理的数据众多,因为格

式错误或api错误造成图片无法显示的情况,我们会予以删除.所以会影响您的广告及收录质量，请您认真对待API的内容.

5、图片无法抓取的情况,主要有以下几个方面的原因:

<1>图片地址必须为绝对路径,请不要使用相对地址

<2>扩展名必须为jpg,gif或png,请不要使用其他后缀名,

<3>图片不要太大,2345的图片标准格式大小为440X282,请在保证清晰的情况下保持大于等于此比例，图片质量越小抓取速度越快。

<4>服务器限制了防盗链,防抓取程序,我们无法抓取到

<5>服务器不稳定.请联系机房维护或使用稳定的服务器.,

6、API里各城市列表第一个商品为主推，如只有全国一个城市标签则所有商品列表中的第一个为主推。各地方城市的本地服务的产品在API里的权重

要要高于全国商品的权重。

2345团购导航合作api操作手册

上海瑞创-产品中心三部第10页共12页整理人：王远成

7、API当天如果从产品列表里更换主推，一定要保证产品链接，图片链接，产品标题及描述与列表中的不同（等同于重新编辑商品），否则会导致更换

的主推无法显示。

8、老版本的API会对

种的过滤我们也知道可以通过str_replace函数或其他函数来实现的，但这样还是会影响我们的采集速度！使用函数过滤花的时间不会很多，但商

品数量一多过滤也会造成采集速度的变慢！

9、每行数据最大不要超过2048字节.

10、网站对采集API做了一次过滤操作，同一城市下如果有标题，图片地址或商品链接相同的商品，程序会认为是已经存在的商品。新商品将不会

被采集到，只更新原来存在的那个商品的收藏数，截止时间和购买人数等。如果你们的商品有提前下架或结束需要重新在API中更新下该商品的消

费结束时间，否则2345团购和团购网站的商品会造成不同步。如果你们在2345的商品如果要下架，只要API中再次抓取时的那个商品消费结束时

间填一个比当前时间早的时间就行！或者商品不在API中显示也会自动下架。

六、API常见问题解答

Q1:站点链接siteurl填写的是网站主页的链接吗？

A：不是，siteurl填写的是网站在该城市站点下的url，如：/。

Q2:要想让商品在每个城市站点都显示，要怎么实现呢？

2345团购导航合作api操作手册

上海瑞创-产品中心三部第11页共12页整理人：王远成

A：只需在city字段填写"全国"即可，请勿再填别的城市名称，否则会导致商品重复抓取展示。全国只限网购类或部分旅游类产品，其他分类产

品请按照实际城市填写，填写错误直接下架，多次出现停止收录。

Q3:<过期时间>字段有什么要求？

A：该字段表示商品的过期时间，系统会根据这个时间来判断该商品是否过期，所以这个时间值填的是该团购项目结束的时间戳。当天线上产品

如果商家页面显示【团购已结束】的时候，请及时更新API中该商品的，系统下次抓取时会默认该产品已过期并下架。不得直接在

API中删除该商品，系统无法识别删除指令，避免线上展示过期商品，多次出现停止收录。

Q4:酒店的城市可以填"全国"吗？

A：不可以。为了便于用户查找填写所在的城市即可。

Q5:酒店住宿类产品city字段有什么要求？

A：酒店住宿类产品按照酒店所在地填写，多个城市连锁的酒店通票可以按照不同的城市提交多次。

Q6:机票和旅游线路类产品city字段有什么要求？

A：机票和线路类可按照出发地和目的地分别提交两次。

Q7:出境游应该填写哪个城市？

A：出境游按照旅游出发地所在城市填写，若单纯属于境外某景点的门票猜可填写"无"（如：香港迪士尼景点门票）。

Q8:一级分类category是填数字还是文字？

2345团购导航合作api操作手册

上海瑞创-产品中心三部第12页共12页整理人：王远成

A：文字。