导航首页 > 搜狗团购导航API规范

一、 搜狗团购API格式示例

对于各团购站提交的API接口,我们将进行详细审核,审核通过后才会予以收录。提交申请收录信息>>

搜狗团购API格式示例,接口格式如下:

<?xml version="1.0" encoding="utf-8"?><urlset><url><loc>http://www.lashou.com/deal/beijing/27325.html</loc><!-- 商品URLurl 256 bytes [必填]--><apiorder>1</apiorder><!-- 商品排序,升序 [必填]--><data><display><website>拉手网</website><!-- 站点名称 50 bytes [必填]--><siteurl>http://www.lashou.com/beijing</siteurl><!-- 站点链接(请填写各城市对应的页面url,如此处应为http://xxx.baidu.com/beijing/) 256 bytes [必填]--><city>北京</city><!-- 城市名称(城市名称不需要附带省、市、区、县等字,如果是全国范围务必请指明:全国) 16 bytes [必填] --><category>2</category><!--团购商品一级分类 1=餐饮美食,2=休闲娱乐,3=生活服务,4=网上购物,5=酒店旅游,4 bytes [必填] --><subcate>摄影写真</subcate><!--团购商品二级分类,指团购商品一级分类对应的二级分类。注意:每个商品只有一个二级分类, 注意必须按照API分类说明的规范填写,否则无法准确归类16 bytes [必填] --><gscate>婚纱摄影</gscate><!--团购商品三级分类。注意:每个商品只有一个三级分类, 注意必须按照API分类说明的规范填写,否则无法准确归类16 bytes [必填] --><number>单人餐</number><!--新增字段,仅餐饮美食类团购需填写的就餐人数字段。请从以下几个选项中选择填写。1)单人餐;2)双人餐;3)3-4人;4)5-10人;5)10人以上。16 bytes [非必填] --><cinemaid>41</cinemaid><!--影院ID,仅电影票团购需填写的字段。请根据电影院ID表(http://tuan.sogou.com/dianyingpiao/cinema_api.xml)填写对应的影院ID。如支持多家影院,请以英文逗号为间隔,填写每家的ID,如是在接口里查询不到的影院,则可不填。”。256 bytes [非必填] --><reservation>1</reservation><!--本团单是否需要预约,0表示无需预约,1表示需要预约。256 bytes [本地团购必填] --><shops><shop><shopName>俏江南(亦庄店)</shopName><!--支持多分店的必须提交每家分店的名称。256 bytes [本地团购必填] --><shopAddress>北京市大兴区经济技术开发区文化园东路6号亦庄创意生活广场3层03C01号商铺</shopAddress><!--支持多分店的必须提交每家分店的地址。256 bytes [本地团购必填] --><shopTel>010-66666666</shopTel><!--支持多分店的必须提交每家分店的联系电话,区号与电话用英文中横杠分隔,多个电话以英文逗号分隔。256 bytes [本地团购必填] --></shop><shop><shopName>俏江南(阳光店)</shopName><shopAddress>北京市亚运村安立路68号阳光广场首层东侧门</shopAddress><shopTel>010-61111111</shopTel></shop> </shops><major>1</major><!--同一个城市如果推出多个分类的团购商品,需要为每个分类设置一款商品为今日主打商品,主打商品的这个字段是为1,非主打商品为0, 1bytes [值可为0,字段必须有]--><title>仅售190元再返38元拉手返利!金钱豹携拉手再度狂卷而来!</title><!-- 商品标题 512 bytes[必填] --><image>http://s1.lashouimg.com/lasho_pic/go/00/00/02/73/27325</image><!-- 商品图片url 256 bytes [必填] --><startTime>1300896000</startTime><!-- 商品开始时间 10 bytes [必填]--><endTime>1301155200</endTime><!-- 商品结束时间 10 bytes [必填]--><value>238.00</value><!-- 商品原价 12 bytes [必填]--><price>190.00</price><!-- 商品现价 12 bytes [必填]--><rebate>8</rebate><!-- 商品折扣 6 bytes [必填]--><bought>168</bought><!-- 已购买人数 10 bytes [必填]--></display></data></url><url>...</url></urlset>

二、 常见问题解答

1. API接口检验

在提交接口前,请参照API接口说明检查个字段是否符合要求,是否包含非法字符,不要直接包含<,>,&,\r,\n,单引号,双引号,[,]等这些符号(如需包含请用HTML编码)。含中文的字段尽量使用<![CDATA[...]]>包裹。

 

2. 如何在接口中添加多个城市

在一个xml文件中,如果团购项目是面向【全国】的,只需要把city字段的值写成【全国】,系统会自动给每一个开放的团购城市添加一个该团购项目。如果团购项目已经标记为【全国】的,尽量不要在其它城市重复添加该项目。

 

3. 数据更新的问题

每次更新数据的时候,startTime这个字段的值要比上次更新时该字段的值要大,譬如加1,例如之前startTime是【1282060800】,更新数据的时候把startTime变为【1282060801】,只有这样才能保证输出的是最新的数据。

对于长期团购,尽量在每日的API中更新内容,避免出现过期。

 

4. 图片规格限制

接口中提供给搜狗团购导航的团购图片,请提供一张长宽比例约为10:7、尺寸约为300 x 205的图片,在保证图片质量和色彩的前提下,图片大小压缩控制在15k-30k左右。

 

5. 商品分类说明

必须按照该表格的对应关系选择商品分类,否则不能准确归类。

一级分类

二级分类

三级分类

说明

餐饮美食
category=1

自助餐

 

 

火锅

 

 

香锅烤鱼

 

麻辣香锅、烤鱼

烧烤

 

 

蛋糕

 

 

地方菜

川菜

 

 

鲁菜

 

 

湘菜

 

 

云贵菜

 

 

江浙菜

 

 

北京菜

 

 

清真菜

 

 

东北菜

 

其他

海鲜

 

 

日韩料理

 

 

西餐

 

 

甜点饮品

 

甜品店、咖啡馆、茶馆

快餐休闲

 

 

其他

 

 

 

 

 

 

 

 

 

 

休闲娱乐
category=2

电影票

 

 

KTV

 

 

运动健身

 

健身中心、瑜伽、舞蹈、击剑等运动类场所

游泳

游乐电玩

 

电玩城、桌游、真人CS等游乐类场所

酒吧

赛事演出

 

 

景点郊游

 

 

温泉洗浴

 

 

其他

 

 

 

 

 

 

生活服务
category=3

摄影写真

婚纱摄影

 

艺术写真

 

儿童摄影

 

证件照

 

美发

 

 

美容美体

 

美容中心、减肥中心、产后瘦身等美容美体类场所

足疗按摩

 

 

美甲

 

 

体检

 

 

口腔

 

 

教育培训

 

各种教育培训机构、培训班

汽车养护

 

 

配镜

婚庆服务

婚庆策划、婚服定制等

其他

 

 

 

 

 

 

 

 

 

 

网上购物
category=4

服装

女装

 

男装

 

T恤

男女T恤、POLO衫

连衣裙/裙子

连衣裙、短裙、长裙等

衬衫

男女长袖、短袖衬衫

长裤

男女牛仔长裤、休闲长裤、西裤等

短裤

男女牛仔短裤、运动短裤、休闲短裤

针织衫/毛衣

男女针织衫、毛衣、针织开衫、毛背心等

大衣/外套

男女夹克、风衣、大衣、男士西服等

棉服/羽绒服

男女棉服、棉衣、羽绒服、羽绒背心等

打底裤

打底衫

卫衣/运动服

运动套装、运动上衣、运动裤、卫衣

内衣/家居服

内衣、文胸、家居服、保暖内衣

吊带/背心

 

童装

 

袜子

袜子、丝袜

雪纺衫

 

小西服

女士小西服

其他

 

配饰

眼镜

太阳镜

首饰

戒指、耳环、耳钉、项链、吊坠、手镯等

帽子

 

腰带

 

围巾

 

手套

 

烟具

打火机等

其他

 

箱包

女包

 

男包

 

钱包

 

功能箱包

旅行箱、拉杆箱

鞋靴

女鞋

 

男鞋

 

运动鞋

 

单鞋

 

凉鞋/凉拖

 

帆布鞋

 

雪地靴

 

靴子

男女长靴、短靴(不含雪地靴)

皮鞋

男女皮鞋

童鞋

 

化妆品

面部保养

面膜、面霜等

眼唇保养

眼霜、唇膏等

身体护理

护手霜、洗发水、洗面奶、护发素、身体乳等

彩妆

 

香水

 

美容工具

 

男士护肤

 

其他

 

手表

 

 

运动户外

运动装备

运动器材、运动背包等

户外用品

户外背包、户外装备等

其他

 

手机数码

手机

 

手机配件

 

摄影摄像

 

电脑数码

 

时尚影音

MP3、MP4、音箱、耳机等

其他

 

家用电器

生活电器

电熨斗、电吹风等

厨房电器

豆浆机、食品加工机等

个人护理

电动剃须刀等

健康电器

电动按摩设备等

其他

 

生活家居

床上用品

家纺用品

厨卫用品

 

清洁用品

 

生活日用

 

成人用品

 

其他

 

汽车配件

汽车保养

 

汽车饰品

 

其他

 

图书音像

图书

 

DVD

 

软件

 

食品饮料

零食

 

茶酒饮料

 

水果生鲜

粮油蔬果

 

保健品

 

其他

 

母婴玩具

妈妈用品

 

宝宝用品

 

玩具

 

其他

 

0元抽奖

 

 

其他

 

 

 

 

 

 

酒店旅游
category=5

酒店住宿

 

 

国内游

 

 

周边游

 

 

出境游

 

 

港澳游

 

 

景点门票

 

 

其他

 

 

团购API注意事项:
1. 务必按照新API格式设置商品一级、二级、三级分类。一级分类共5种:
1.餐饮美食 2.休闲娱乐 3.生活服务 4.网上购物 5.酒店旅游。字段写对应的数字即可。
二级、三级分类请按照商品分类格式表认真填写每个商品的二级、三级分类,字段直接写二级、三级分类名称。
2.关于主打。请为你希望覆盖的每个城市的每个一级分类设置一个主打商品。这样才能保证在第一轮展示。但如果是网购类商品,只需统一设置成全国主打即可。
3.关于网购类商品。每个网购类商品只需设置为全国即可,不需要每个城市重复设置。
4.注意同一个站的各个城市的主打商品尽量不要出现商品URL重复,如果频繁出现、数量较多商品数据会被自动清除。
5.关于商品地址。对于本地类团品尽量填写准确的商户地址,有多个地址只填写一个。如果是网购类商品不要填写地址,字段值为空即可。
6.关于商品图片。尽量按照长宽比例约为10:7、尺寸为300 x205或以上这个标准提供图片。否则图片不清晰或者变形,会影响商品点击效果。

三、 不规范API说明

各团购站提交的API,我们会在提交时进行严格审核;开始收录后,也会定期进行机器和人工检查。对于不规范的团购API,将不予通知直接删除。不规范情形举例:

 

1、商品重复

例如:在同一个城市下,出现两款或多款重复团购;已经被标记为【全国】的团购,在其它城市又被标记为【XX城市】进行重复展现。商品重复会影响API权重和展现。

 

2、实际城市与city标记不符合

例如:商品实际为全国性质的邮寄类商品,却刻意标记为【北京】【上海】等地方城市,不符合商品的真实信息。实际为【北京】的本地服务商品,却在【上海】也被展现。

 

3、主打商品

没有设定major=1的商品,会影响商品的排序和展现;重复多次设定无实际意义的major=1内容,也会影响API排序和展现。

 

4、商品开始时间

startTime距当前时间已经超过了10天。即把所有历史商品都积累到一起,刻意堆积团购商品的数量。没有及时更新商品开始时间会影响API权重和展现。

 

5、伪造团购属性

对API中团购的属性(包括标题、描述、图片、价格、时间、折扣、购买人数等)进行伪造、堆砌,即API信息与最终展现内容不符,API中的信息为虚假信息,或者团购项目实际无意义或不存在。伪造团购信息将直接被停止收录。

 

如果有其它疑问,请到意见反馈页面填写具体内容并提交。