美团请求API使用说明.docx

按条件获取指定团购项目信息——请求API基础信息功能描述:按照所在城市、城区、品类、关键词等多种条件搜索团购信息获取方式:HTTPGET;合作方按需求拼接url,美团根据合作方的请求字段,返回经过加工的推荐结果是否需要授权:需要提供合作方广告位key值线上地址示例:./data/api?offset=0&limit=10&city=北京&category=美食&district_name=朝阳&key=广告位key值&keyword=火锅&sort=1或者./data/api?lat=&lon=&radius=10&offset=0&limit=10&key=GADfHn74Ct8mq6iwPWQBjZdl25LYE3NX&category=美食&keyword=火锅注意事项:如不加团购项目的数量限制,则默认返回100个项目;{}处需替换成站长被分配到的key,获取方式如下:方法1:登陆美团联盟——获取广告——创建广告后点击自定义链接——提交方法2:获取广告——获取API,各个API地址中均包含key值此处即为该广告位的key请求字段:1)按城市,地区,和品类进行查询:名称是否必须说明key是合作方广告位标识city是城市名称,如:北京,可选范围见美团开通城市列表(./data/citylist)districtname否包含团购信息的城市区域名,如:朝阳区,海淀区category否包含团购信息的分类名,支持的分类名称如下:美食,网购,服务,休闲,旅游,酒店,电影,抽奖注意:当category为网购时,city必须为‘全国’(网购单都为全国单)keyword否关键词,搜索范围包括商户名、商品名、地址等offset否偏移,默认是0,分页是从0开始的limit否返回的团单结果条目数上限,默认100sort否查询结果排序策略:1-销量由高到底2-价格由高到低3-价格由低到高4-开始时间按距离现在由近到远默认排序策略为11)按经纬度进行查询:名称是否必须说明key是合作方广告位标识category否包含团购信息的分类名,支持的分类名称如下:美食,网购,服务,休闲,旅游,酒店,电影,抽奖注意:当category为网购时,city必须为‘全国’(网购单都为全国单)keyword否关键词,搜索范围包括商户名、商品名、地址等lat否经度,,传其他非法数字会返回nodeallon否纬度,,格式要求同上radius否在有经纬度情况下有效,默认10千米,单位千米,可以为小数offset否偏移,默认是0,分页是从0开始的limit否返回的团单结果条目数上限,默认100返回内容字段:格式与美团开放API相同,主要字段如下:名称说明reservation是否需要预约destination旅游单目的地,非旅游单为空city_name项目所在城市名city_id城市拼音city_urldeal所在城市主站地址deal_id项目编号deal_title项目标题deal_url项目主站地址dea