美团请求API使用说明

按条件获取指定团购项目信息——请求API

基础信息

功能描述：按照所在城市、城区、品类、关键词等多种条件搜索团购信息

获取方式：HTTP GET；合作方按需求拼接url，美团根据合作方的请求字段，返回经过加工的推荐结果

是否需要授权：需要提供合作方广告位key值

线上地址示例：

ituan/data/api?offset=0&limit=10&city=北京&category=美食&district_name=朝阳&key=广告位key值&keyword=火锅&sort=1

或者

ituan/data/api?lat=40.0061776307&lon=116.4875583900&radius=10

&offset=0&limit=10&key=GADfHn74Ct8mq6iwPWQBjZdl25LYE3NX&category=美食&keyword=火锅

注意事项：

 如不加团购项目的数量限制，则默认返回100个项目；

 {}处需替换成站长被分配到的key，获取方式如下：

方法1：登陆美团联盟——获取广告——创建广告后点击自定义链接——提交

方法2：获取广告——获取API，各个API地址中均包含key值

此处即为该广告位的key

请求字段：

1）按城市，地区，和品类进行查询：

名称	是否必须	说明
key	是	合作方广告位标识
city	是	城市名称，如：北京，可选范围见美团开通城市列表（ituan/data/citylist）
districtname	否	包含团购信息的城市区域名，如：朝阳区，海淀区
category	否	包含团购信息的分类名，支持的分类名称如下：美食，网购，服务，休闲，旅游，酒店，电影，抽奖注意：当category为网购时，city必须为‘全国’ （网购单都为全国单）
keyword	否	关键词，搜索范围包括商户名、商品名、地址等
offset	否	偏移，默认是0，分页是从0开始的
limit	否	返回的团单结果条目数上限，默认100
sort	否	查询结果排序策略：1-销量由高到底2-价格由高到低 3-价格由低到高 4-开始时间按距离现在由近到远默认排序策略为1

1）按经纬度进行查询：

名称	是否必须	说明
key	是	合作方广告位标识
category	否	包含团购信息的分类名，支持的分类名称如下：美食，网购，服务，休闲，旅游，酒店，电影，抽奖注意：当category为网购时，city必须为‘全国’ （网购单都为全国单）
keyword	否	关键词，搜索范围包括商户名、商品名、地址等
lat	否	经度，比如40.00713，传其他非法数字会返回no deal
lon	否	纬度，比如116.49007, 格式要求同上
radius	否	在有经纬度情况下有效，默认10千米，单位千米，可以为小数
offset	否	偏移，默认是0，分页是从0开始的
limit	否	返回的团单结果条目数上限，默认100

返回内容字段：

格式与美团开放API相同，主要字段如下：