本页目录现状附近优惠查询 GET /v1/meituan/nearby优惠跳转链接 GET /v1/meituan/convert效果追踪 GET /v1/meituan/orders订单事件回推 POST /v1/meituan/call使用建议常见错误
本地生活优惠(美团外卖 / 到店 / 酒店)
源头淘聚合美团本地生活优惠:外卖红包、到店套餐、酒店券。与商品推荐不同,本地生活是优惠查询 + 跳转领取形态——没有货架和库存,用户跳转美团 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 侧无需处理。
使用建议
- 外卖红包:
nearby(带用户经纬度)→ 挑commissionPercent高且销量好的券 →convert取链接给用户。 - 酒店券:
nearby+listTopiId=3(同城热销)或platform=2&bizLine=3→convert(sid用小写字母+数字)。 - 展示口径与商品推荐一致:不出现"返利/拿佣金"字样,价格以美团 App 为准。
常见错误
| 现象 | 处理 |
|---|---|
| 400 请求无权限 | 接口权限状态以平台开通为准;新开通后有生效延迟,稍后重试 |
| 空结果 | 到店/酒店类务必带经纬度或 listTopiId;外卖券默认全国 |