本地生活优惠(美团外卖 / 到店 / 酒店)

源头淘聚合美团本地生活优惠:外卖红包、到店套餐、酒店券。与商品推荐不同,本地生活是优惠查询 + 跳转领取形态——没有货架和库存,用户跳转美团 App 领券或购买,开发者获得分成。

现状

接口灰度联调中(2026-10-09 开通)。酒店/到店优惠活动持续开放,外卖券按城市与位置供给。接入前可先熟悉参数,正式开放会在 更新日志 公告。

附近优惠查询 GET /v1/meituan/nearby

参数 类型 必填 说明
longitude / latitude int 是 经纬度 ×1,000,000 的整数(如 116.457 → 116457000)
searchText string 否 关键词(1-100 字符,全品类搜索)
listTopiId int 否 榜单主题:1 精选 / 2 今日必推 / 3 同城热销 / 5 实时热销(到店酒店/门票类本项必填且只支持 3)
platform int 否 1 到家(外卖等)/ 2 到店
bizLine int 否 二级业务:platform=1 时 5 医药;platform=2 时 1 到餐 / 2 到综 / 3 酒店 / 4 门票
cityId / businessAreaId string 否 城市/商圈编码(榜单、搜索场景生效)
sortField / ascDescOrder int 否 排序:1 售价 / 2 销量 / 3 佣金比例 / 6 离我最近
categoryId int 否 品类筛选(仅外卖商品)
pageSize / pageNo int 否 默认 20 / 1

注意:经纬度不传时,到店/医药类默认北京,外卖券默认全国。

响应含商品券信息(名称/原价/售价/月销/券数量/有效期)与佣金比例(commissionPercent,返回值 ÷100 = 佣金比例,如 400 = 4%)、可用门店与配送距离。

优惠跳转链接 GET /v1/meituan/convert

把活动/商品/链接转成带追踪的推广链接,用户打开后进入美团 App。

参数 类型 必填 说明
act_id string 三选一 活动 ID(从运营渠道或活动列表获取,如酒店类活动)
product_view_sign string 三选一 商品券展示 ID(查询接口返回的 productViewSign)
text string 三选一 目标链接(美团长/短链/deeplink/小程序链接,≤200 字)
link_type int 否 1 H5 长链(默认)/ 2 H5 短链 / 3 deeplink / 4 微信小程序路径 / 5 团口令 / 6 小程序码
sid string 否 二级追踪标识(≤64 字符;酒店业务禁大写字母和冒号,其余业务禁冒号)

响应 click_url:推广链接(linkTypeList 可一次返回多种形态,见 referralLinkMap)。

效果追踪 GET /v1/meituan/orders

按时间段查询转化订单(用于对账与分成核对)。参数:start_time / end_time / page / page_size / type。

订单事件回推 POST /v1/meituan/call

美团侧订单事件会主动回推到该地址(平台已配置)。回推体原样落库用于对账,agent 侧无需处理。

使用建议

  1. 外卖红包:nearby(带用户经纬度)→ 挑 commissionPercent 高且销量好的券 → convert 取链接给用户。
  2. 酒店券:nearby + listTopiId=3(同城热销)或 platform=2&bizLine=3 → convert(sid 用小写字母+数字)。
  3. 展示口径与商品推荐一致:不出现"返利/拿佣金"字样,价格以美团 App 为准。

常见错误

现象 处理
400 请求无权限 接口权限状态以平台开通为准;新开通后有生效延迟,稍后重试
空结果 到店/酒店类务必带经纬度或 listTopiId;外卖券默认全国