我要收藏本页

百度首页 hao123首页 登录 注册

百度团购
其他城市
  • 团购排行榜
  • 我的团购
  • 平台介绍

    • 平台介绍
  • 商务合作

    • 合作流程
    • 资质要求
    • 申请收录
  • API帮助文档

    • API格式
    • API字段介绍
    • API分类说明
    • API格式示例
    • API校验地址
    • API常见问题
  • 账号通开发帮助

    • 合作简介
    • 开发步骤
    • 自测方法
    • 提交测试
    • 常见问题
    • 平台介绍

      "hao123团购导航"已正式升级为"百度团购导航"(http://tuan.baidu.com/ ),升级后的团购导航平台汇集了国内主流团购网站最新最全的团购信息,为网友带来全新团购消费体验。


      作为"hao123团购导航"的升级产品,"百度团购导航"在延续原有产品优点的基础上,进行了大力度的革新,无论是功能服务还是外观界面都做了跨越性的改进。


      百度团购导航力争打造一个权威、公正的团购导航,给广大网民提供全新团购平台。我们致力于通过领先的技术和严格的准入,为网民浏览、选购团购商品提供一个简单便捷、安全可靠的在线平台,同时还开发出多项功能产品,以满足大家个性化的团购需求。


      今后百度团购导航还将对产品功能、使用体验等进行不断的优化和提升,致力于为广大网民打造一个放心、优质、便捷的团购环境。

    • 合作流程

      • 申请收录

        符合收录资质要求

      • ›
      • 资料提交及审核

        提交申请收录信息→审核通过→获得API及一站通接口文档。

      • ›
      • API及一站通开发

        开发API及一站通接口 → 自测通过 → 按照API及一站通开发指南提交测试。

      • ›
      • 测试通过

        校验API解析是否正常及各字段填写是否符合规范;一站通登录及订单返回情况。

      • ›
      • 收录上线

        收录上线,抓取API提交的产品,保障线上展示效果。

    • 资质要求

      网站基本资质:
      • 1公司资质;
      • 2ICP证;
      基本服务保障:
      • 1正品保障;
      • 2售后保障;
      稳定性和用户认知:
      • 1上线时间:2个月以上;
      • 2无不良信用历史;
    • 申请收录

      如果您的网站资源如果满足以上基本要求,请按以下格式发送申请邮件至tuangou#baidu.com(#换成@)申请收录。

      邮件标题:例如【拉手网】百度团购导航收录申请

      邮件正文:

      • 1网站名称:
      • 2网站链接地址:
      • 3网站上线时间:
      • 4ICP号/备:
      • 5日平均新增团购商品数:
      • 6目前已被哪几家团购导航收录:
      • 7网站简介:(特色说明或主要商品分类等)
      • 8市场负责人:
      • 9市场负责人电话:
      • 10市场负责人QQ:
      • 11市场负责人邮箱:
      • 请在附件中添加营业执照及产品授权书扫描件!

      如果申请内容符合格式要求,且满足百度团购导航收录标准,我们会在五个工作日内回复并通知您开发API及一站通接口。

      由于收录团购网站需要满足一定的条件,我们会记录所有申请收录的站点,审核人员将逐一审核,目前暂时未被收录的网站我们也会持续关注贵站的成长,希望经过你们努力运营之后,站点质量能够得到快速提升,届时可再向我们提交申请。

    • API格式


    • API字段介绍

      字段ID 字段名 字段名 字段说明 属性 限制 必填项
      1 loc 商品url 描述详细信息页面的ULR地址(新增商品的url不要覆盖老的商品的url) URL 256B 是
      2 website 站点名称 站点名称 文本 50B 是
      3 siteurl 站点url 该城市的站点url URL 256B 是
      4 city 城市 城市名称(城市名称不需要附带省、市、区、县等字,如果是全国范围请指明:全国) 注意:只能填写一个城市名称 文本 16B 是
      5 category 团购分类号 团购商品的一级类目,可填写1、2、3、4,分别对应——1代表"餐饮美食",2代表"休闲娱乐",3代表"生活服务",4代表"网上购物" 文本 2B 是
      6 subcategory 细分类 指团购商品一级类目对应的二级类目。 注意:每个商品只有一个细分类, 具体参见API分类说明 文本 16B 是
      7 dpshopid 商家的大众点评网ID 团购商家的大众点评shopid,多个以英文逗号分隔 文本 512B 否
      8 range 商圈名称 团购商家的大概方位,多个以英文逗号分隔,按照填写顺序显示商家 文本 512B 否
      9 address 商家的店面地址 团购商家的具体位置,多个以英文逗号分隔,按照填写顺序显示商家 文本 512B 否 (本地消费类商品必须填写)
      10 major 是否主打 可填写1或者0,1为主打,0为非主打 文本 2B 是
      11 title 商品标题 商品标题(如:原价188元的"玛雅蛋糕"仅售49元!) 文本 512B 是
      12 image 商品图片地址 商品图片url 。图片大小宽*高为266*166,图片大小要小于15K URL 256B 是
      13 startTime 开始时间 团购商品开始时间。(如:1275926400) 文本 10B 是
      14 endTime 结束时间 团购商品结束时间。(如:1291910399) 文本 10B 是
      15 value 商品原价 商品原价 文本 12B 是
      16 price 现价 商品现价 文本 12B 是
      17 rebate 折扣 商品折扣 文本 6 B 是
      18 bought 购买人数 已购买人数 文本 10B 是
      19 name 商品名称 商品名称准确描述,如 "铅笔盒" 文本 512B 否(网上购物类商品必须填写)
      20 Seller 商家名称 商家的准确描述,如"青鸟健身"、"必胜客" 文本 512B 否(本地消费类商品必须填写)
      21 Phone 商家电话 商家的电话号码,多个号码 文本 50B 否
    • API分类说明

      一级分类 二级分类 包含内容 备注
      ID 1 名称:餐饮美食 自助 自助餐(不包含洗浴自助、KTV自主等) 1.所有需要到店消费的餐饮类商品,均可列入此类;
      2.需到门店自提或本地包邮的食品例如蛋糕等,也可以归入此分类;
      3.其他网购类零食商品,均不属于此分类。
      双人套餐 双人饮食套餐
      火锅 火锅、羊蝎子
      麻辣香锅 麻辣香锅
      烧烤 烧烤、烤串、烤羊腿
      烤鱼 烤鱼
      快餐休闲 肯德基、麦当劳、咖啡厅、鲜果时光、冷饮等类似门店商品
      日韩料理 日本料理、韩国料理
      西餐 西式餐点
      地方菜 北京菜,山东菜,四川菜,广东菜,淮扬菜,浙江菜,福建菜,湖北菜,徽菜,湖南菜,上海菜,天津菜等地方菜
      蛋糕 蛋糕、甜点
      其他 以上分类未包含的餐饮美食类商品
      ID 2 名称:休闲娱乐 电影 影院门票、电影卡 1.如单店经营项目包含KTV、台球、畅饮、桌游等,属于桌游吧,归于游乐电玩分类。
      KTV KTV
      运动健身 健身中心、瑜伽、舞蹈、击剑等运动类商品
      游乐电玩 电玩城、桌游、真人CS、陶艺吧等游乐类商品
      演出活动 话剧、演唱会、相声、展览、赛事等活动类商品
      洗浴 洗浴中心、会馆、会所、汗蒸、温泉等以洗浴休闲为主的商品(例如:权金城、塞纳河等机构)
      其他 以上分类未包含的休闲娱乐类商品
      ID 3 名称:生活服务 美容美体 美容中心、减肥中心、产后瘦身、美甲店等美容美体类商品 1.如店内包含美容、美发、美甲等多种经营项目,请以主营项目或当次团购中主推项目来正确提交分类;
      2.诸如课程培训、证件照、宠物美容、公益捐款等商品可提交至本分类中的“其他”分类下;
      写真 个人写真、孕妇写真
      美发 烫发、剪发、染发、造型
      婚纱摄影 婚纱摄影
      儿童摄影 儿童摄影
      口腔 洗牙、补牙、正畸等口腔科商品
      体检 体检机构、专科医院体检
      保健按摩 足疗、推拿、艾灸等保健按摩类商品
      汽车养护 加油卡、洗车、保养
      其他 以上分类未包含的生活服务类商品
      ID 4 名称:网上购物 服装 服装、睡衣、内衣、袜 1.此分类下均为邮购商品;
      2.鲜花、图书等商品可提交至本分类中的“其他”分类下;
      数码家电 数码、数码配件、手机、电脑、家用电器
      生活家居 家居用品、生活用品、五金用品
      化妆品 化妆品、彩妆、美颜工具、美颜保健食(饮)品
      鞋靴 鞋、靴、拖鞋
      食品饮料 零食、食品、饮料、茶等
      玩具 玩具、摆件、布偶、模型等成人玩具
      手表 手表
      饰品 饰品、珠宝、手套、围巾、皮带、墨镜等饰品及配饰
      箱包 拉杆箱、背包、皮包、钱包等箱包类商品
      抽奖 0元抽奖
      母婴用品 婴儿奶粉、婴儿服饰、少儿玩具、防辐射衣等母婴用品
      其他 以上分类未包含的网上购物类商品
      ID 5 名称:酒店旅游 酒店住宿 酒店、旅馆、快捷酒店、酒店代金券(卡)
      旅游 旅游团、自助游、近郊游、度假村、旅游代金券等旅游商品
      景点门票 景点门票、全国景点联票
    • API格式示例

    • API校验地址

      提交您的API之前,请您先自行测试API是否正确,测试地址为:
    • API常见问题

      • Q:站点链接siteurl填写的是网站主页的链接吗?

        A:不是,siteurl填写的是网站在该城市站点下的url,如:http://bj.meituan.com/。

      • Q:可以设置多个主打产品吗?

        A:每个城市只能设置一个主打产品。

      • Q:要想让商品在每个城市站点都显示,要怎么实现呢?

        A:只需在city字段填写"全国"即可,请勿再填别的城市名称,否则会导致商品重复抓取展示。全国只限网购类或部分旅游类产品,其他分类产品请按照实际城市填写,填写错误直接下架,多次出现停止收录。

      • Q:<endTime>字段有什么要求?

        A:该字段表示商品的过期时间,系统会根据这个时间来判断该商品是否过期,所以这个时间值填的是该团购项目结束的时间戳。当天线上产品如果商家页面显示【团购已结束】的时候,请及时更新API中该商品的<endTime>,系统下次抓取时会默认该产品已过期并下架。不得直接在API中删除该商品,系统无法识别删除指令,避免线上展示过期商品,多次出现停止收录。

      • Q:酒店的城市可以填"全国"吗?

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

      • Q:酒店住宿类产品city字段有什么要求?

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

      • Q:机票和旅游线路类产品city字段有什么要求?

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

      • Q:出境游应该填写哪个城市?

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

      • Q:一级分类category是填数字还是文字?

        A:数字。

      • Q:餐饮美食为什么不包括网购的食品?

        A:餐饮美食主要是指由商家发起的团购,用户可以到店消费的商品。而网购食品则属于将商品寄到用户手中无需到店消费的商品。

      • Q:美容养生这个细分类是指哪些商品?

        A:美容养生特指用户可以持券到店里销售服务的商品,如:足疗;而有美容养生作用的化妆品应属于"化妆品"类、足浴用品应属于"生活家居"类。

      • Q:汽车美容、宠物美容等类似的该划为哪一类?

        A:属于生活服务类的"其他",即3-其他。

      • Q:公益产品(例如基金会的捐款产品)属于哪一类?

        A:属于生活服务类的"其他"。

      • Q:培训班的课程优惠券属于哪一类?

        A:属于生活服务类的"其他"。

      • Q:商务会所的优惠券里包含了会所的运动、住宿、洗浴、自助餐等,这样的优惠券属于哪一类?

        A:属于休闲娱乐类的"其他"。

      • Q:DVD影碟属于哪一类?

        A:属于网上购物的"其他"。

      • Q:游乐电玩包括哪些类别?

        A:包括电玩城游戏币、真人CS、陶艺吧、桌游吧等。

      • Q:采摘应该归为游乐电玩还是旅游?

        A:旅游。此外景点门票也应该归为旅游类。

    • 合作简介

      百度团购(tuan.baidu.com)是原hao123团购的升级版,汇集了国内主流团购网站的大量精品团购信息,致力于为广大网民打造一个放心、优质、便捷的团购环境。

      "百度账号通"平台是一种基于标准安全的Oauth用户授权协议的认证服务。加入百度团购合作平台后,百度用户将可以快速的登陆您的网站,进行相关产品的咨询和购买。

      百度团购 OpenAPI是百度团购的对外开发api,第三方网站可以通过此api获取用户信息或进行信息交互,目前支持的功能:用户订单信息回传、提醒用户及时使用消费券以及消费券延期信息。

    • 开发步骤

      开发步骤:帐号通和OpenAPI开发流程2.0
      • 1注册百度app,获取api key和secret key,注册地址。
        建立应用时请选择站外应用,注意“应用服务器列表”(支持”*”通配符)和绑定站点域名必须填写正确,否则访问百度团购api时会提示“Unauthorized client IP address”或#1105错误。注册并提交审核。
      • 2完成账号通开发
        账号通有两种形式,一种为用户在第三方站点选择登陆,另一种为用户通过团百链接到第三方站点。
        • 2.1在第三方站点选择登陆 实现一站通:

          一站通:所谓一站通,是指用户通过第三方站点,使用百度账号可以快速登陆。

          完成oauth帐号通开发,文档地址 ,建议使用“Authentication Code”方式获取token;获取用户信息的api见:API帮助文档

        • 2.2通过团百页面引导到第三方实现一号直达:

          一号直达:所谓一号直达,是指用户从团百页面是登陆状态,到第三方网站也是登陆状态。(参考地址: 一号直达):


          一号直达实现效果:

          用户有两种状态, 未登录和已登录。登陆又分为登陆已授权和 登陆未授权。

          我们希望团百登陆的用户到第三方站点,对于未授权的用户跳转到授权页面,对于已登录用户实现自动登陆绑定。未登录团百用户建议自行跳转到该产品页面即可。

          绑定方式:第三方会针对所有未绑定的百度用户,自动生成一个第三方网站的帐号,并将其与百度用户关联起来,在这个过程中,无须用户做任何操作。建议第三方绑定的账号和团百账号一致。


          一号直达实现方式:

          从团百页面点击第三方商品链接时,我们会在这些链接中后面添加如下参数tn=baidutuan_tg ,第三方站点根据url后面带的参数判断,嵌入下面JS代码,实现一号直达。(详细内容参考: 一号直达):



          账号绑定实现方式参考:

          当第三方网站获得百度用户id后,即可向自己的数据库中查询,此用户是否之前已绑定过,如已绑定,则按照流程对已绑定用户处理,否则按对于用户未绑定的处理。

          1.用户已绑定的处理

          此时第三方可根据百度用户id查询到已绑定的自身的用户id,并根据此用户身份,为用户进行登录。

          2.对于用户未绑定的处理

          发现该百度用户还未绑定第三方网站自己的用户,则此时应该对用户进行绑定操作。

          页面服务器端需要加入的逻辑(官方样例代码)

          判断cookie中是否存在session。


          签名算法 :

          签名算法请阅读如下http://dev.baidu.com/wiki/connect/index.php?title=参数签名算法

      • 3申请openapi权限
        完成oauth帐号通开发后,发信到 wu_yue@baidu.com 申请Openapi权限(标题注明站点名称,内容需要包含申请的应用id和站点的登录页面url)。
      • 4完成开发openapi订单回传
        完成开发openapi订单回传/cps的3个接口(saveOrder,updateExpire,useOrder); 访问此api,由于可能存在异步操作,所以需要使用通过Client Credentials方式获取access token。
    • 自测方法

      按照提供方法开发完成后,通过两个入口进行测试:

      • 1一站通

        在第三方网站登录时,选择使用百度联合登录方式并用百度帐号登录成功,并且购买商品之后有订单回传。按以下四个方面进行检测:

        • 1、团购网站在登陆页面、购买登陆页面添加上我们提供的百度登陆icon(icon请见phpsdk文档)。
        • 2、测试是否可以使用百度账号登陆(如不行,请删除百度登陆icon,查找原因并及时修复)。
        • 3、登录成功之后,在第三方站点购买商品,并支付费用(不能用货到付款方式)。中间不应该出现登录状态退出的情形。
        • 4、支付成功后,到tuan.baidu.com中“我的团购”查看有没有返回刚才购买商品的订单数据,检查图片、商品url、价格、“订单详情”是否正确。
      • 2一号直达

        在团百登录状态下,点击第三方商品或网站名,进入第三方网站页面,第三方站点或者是已登录状态,或者是授权确认页面,但都不需要重新使用帐号登录。

        2.1 已收录站点

        • 1.使用百度帐号成功登录tuan.baidu.com。
        • 2.在tuan.baidu.com中搜索到此站点的一个商品,依次点击“站点名称”、“去看看”,跳转到第三方商品页面中,有两种情况:

          (1)页面是已登录状态。(登陆帐户同百度账户)。

          (2)跳转第三方页面授权页面,只需要允许授权,不需要重新填写百度帐号。(登录的帐号显示的是百度帐号)。

        • 3.登录到第三方页面之后,在此站点购买一个商品,直到进入去支付页面,都一直保持登录状态。

        以上条件都满足,则一号直达通过。

        2.2 预收录站点

        如果当前站点暂未收录产品,则先完成“一站通”的测试部分,等团百收录了此站点的商品之后,再进行“一号直达”的测试。

      • 3CPS测试
        具体合作事宜请联系团百商务
        联系方式:
        商务合作接口人
        谢宗辙
        大客户销售部
        TEL:010-59927360
        QQ:272340017
        Baidu Hi: xiezongzhe@baidu.com
        Mail: xiezongzhe@baidu.com

    • 提交测试

      自测确认无误后,请发送邮件到 wu_yue@baidu.com申请测试

      邮件标题为:XX团-团百账户通测试申请

      附件标题为:XX团-团百账户通测试申请表

      我们测试确认无误后将在线上添加团百账号通icon,请关注线上效果。

      申请表格下载

    • 常见问题

      • Q:百度团购帐号通是什么?

        A:百度团购帐号通是百度团购为团购网站提供帐号共享的一种方式。团购网站接入百度团购帐号以后,用户可以直接到团购网站登陆百度账号进行消费。

      • Q:百度团购OpenAPI是什么?

        A:百度团购OpenAPI是百度团购的对外开发api,第三方网站可以通过此api获取用户信息或进行信息交互,目前支持的业务接口包括(1.1版本详情请见《OpenAPI文档》,2.0见这里):

        a.购买订单信息提交

        为用户提供一个统一的信息管理和订单导航

        b.消费券延期

        通知用户消费券进行了延期

        c.消费券使用

        提醒用户及时使用消费券

      • Q:百度团购帐号通接入采取什么技术方式?

        A:百度团购(百度)帐号接入,是基于OAuth1.0a/Oauth2.0标准协议的开放授权机制,适合有服务端配合的应用使用。

      • Q:如何获取sdk?

        A:由于2.0认证和api访问非常简单,建议不要使用sdk,自己进行http交互;sdk仅供参考,地址:http://dev.baidu.com/wiki/connect/index.php?title=SDK

      • Q:订单回传接口中,tn和baiduid是什么?如何获取?

        A:tn表示流量来源的渠道标识,baiduid表示baidu用户的一个标识;这两个参数都是以参数的方式从百度团购带过来的,如:http://www.didatuan.com/team/3330?tn=baidu_tg&baiduid=3FABB877ACBFD405C769D4966A6C6934

      • Q:什么条件下需要回传订单?

        A:所有百度团购链接过去后在一次浏览行为中产生购买的,或者用户以百度帐号登录购买商品的,都需要回传订单;如果链接中有tn和baiduid参数,则需要同时回传这两个参数(建议记录在cookie中,以保持到用户购买时)。一次浏览行为以浏览器是否关闭为判断,若用户关闭浏览器,算完成一次浏览行为。

      • Q:什么条件下需要调用“消费券延期”或“消费券使用”接口?

        A:只有订单/消费券为用户使用百度帐号登录后产生订单,才需要在进行相关行为(延长有效期/使用消费券)时调用这两个接口。

      • Q:为什么我在调用百度团购OpenAPI时一直提示“session_idisinvalid”?

        A:一般是因为没有开通百度团购OpenAPI权限。开通方式为发送申请的“应用id”到百度团购指定邮箱,并表明网站身份。

      • Q:为什么我在调用百度团购OpenAPI时一直提示“UnauthorizedclientIPaddress”?

        A:请参见帐号通和OpenAPI开发流程。

      • Q:通过百度团购过来的用户不用百度帐号登录也需要回传订单,用什么标识来识别?

        A:所有通过百度团购团购导航引导过来的用户,在请求团购网站商品时,都会自动在团购商品的url后增加两个GET参数“tn=baidu_tg&baiduid=3FABB877ACBFD405C769D4966A6C6”,如:http://www.didatuan.com/team/3330?tn=baidu_tg&baiduid=3FABB877ACBFD405C769D4966A6C693。建议团购网站将次两个参数记入cookie,已在购买时判断是否进行回传(同时也要回传此两个参数的值)。

      • Q:bonus参数如何计算?

        A:如果CPS合同签署完毕,则需要修改订单回传中的bonus参数为实际值(即bonus=订单成交总价*分成比例),快递费不计入订单成交总价和分成金额。

      • Q:为什么会提示{"error":"unauthorized_client","error_description":"The client is not authorized to use this authorization grant type"}?

        A:申请的应用未授权,需要提交审核后,并完成oauth登录上线后,发信到 tuangou@baidu.com ;申请应用审核和Openapi权限(标题注明站点名称,内容需要包含申请的应用id和站点的登录页面url)

      • Q:#1105错误提示是什么意思?

        A:1105表示在申请的应用中绑定的站点域名和当前有区别,请到应用平台自行修改,绑定可以为多个域名,不包含"http://",建议使用根域名。如果已提交审核,需撤销审核才能修改。

      • Q:一号直达签名验证签名不一致?

        A:1、签名时密钥是应用注册时得到的Secret Key
        2、签名包含的参数:(expires_in ,access_token, user,uname,portrait,base domain)

      • Q:通过JS代码,团百用户已经登陆,alert('status')为null

        A:1、check: connect.init('key',{status:true}) 其中key为注册应用是获取的API KEY,注意填写。
        2、check: 测试IP地址, 是否在应用服务器IP列表里面

© 2012 Baidu