获取外卖到家/到店商品数据

开发中

POST

/mt/queryCoupon

请求参数

Body 参数application/json

ascDescOrder

string

仅对到家业务类型生效，未入参榜单listTopiId时：1 升序，2 降序；入参榜单listTopiId时：1 升序，2 降序，并且仅对sortField为1售价排序的时候生效，其他筛选值不生效；其他说明：不填则默认为1升序

可选

bizLine

string

商品所属业务二级分类类型；当字段platform为1，选择到家及其他业务类型时：5 医药，不填则默认为null，返回外卖商品券；当字段platform为2，选择到店业务类型时：1 到餐，2 到综 3：酒店 4：门票度假不填则默认1

可选

latitude

string

定位经纬度的纬度，请传递纬度*100万倍的整形数字，如纬度39.928*100万倍为39928000; 针对到店、到家医药商品业务类型，若未输入经纬度，则默认北京；针对到家外卖商品券业务类型，若未输入经纬度，则默认全国

可选

listTopiId

string

选品池榜单主题ID，到家及其他业务类型支持查询：1 精选，2 今日必推，3 同城热销，4 跟推爆款的商品售卖券（其中到家医药业务类型，本项为必填，且只支持传枚举3）；到店业务类型支持查询：2 今日必推，3 同城热销（全部商品）5 实时热销（其中到店酒店、门票业务类型，本项为必填，且只支持传枚举3）

可选

longitude

string

定位经纬度的经度，请传递经度*100万倍的整形数字，如经度116.404*100万倍为116404000；针对到店、到家医药商品业务类型，若未输入经纬度，则默认北京；针对到家外卖商品券业务类型，若未输入经纬度，则默认全国

可选

pageNo

string

页数，不填返回默认页数1

可选

pageSize

string

分页大小，不填返回默认分页20

可选

platform

string

商品所属业务一级分类类型：1 到家及其他业务类型，2 到店业务类型（包含到店美食、休闲生活、酒店、门票）；

可选

searchId

string

仅搜索场景分页使用，首次调用不用填。查询相同搜索关键词、相同排序规则的下一页数据，需携带填写上次查询时出参中的'searchId'。如变更搜索关键字或排序规则，则也无需填写。

可选

searchText

string

搜索关键字,限制1-100个字符，不支持入参指定Platform、bizLine搜索，搜索范围为全品类。如需使用该字段查询商品信息，则vpSkuViewIds、listTopiId字段必须为空！！！如不为空，则按下述字段优先级执行查询：vpSkuViewIds>listTopiId>searchText。

可选

sign

string

接口签名

可选

sortField

string

1）未入参榜单listTopiId时：支持1 售价排序、2 销量排序；2）入参榜单listTopiId时：当platform为1，选择到家业务类型：外卖商品券类型，支持1 售价排序、 2 销量降序、 3佣金降序，不填则默认为1；到家医药类型，支持2 销量降序、 3 佣金降序，不填则默认为2；当platform为2，选择到店业务类型：支持2 销量降序、 3佣金降序，不填则默认为2。其中listTopiId为5时，仅支持默认排序，sortField不生效；3)通过搜索searchText召回时：支持1综合排序、2价格升序，不填默认为1

可选

timeStamp

string

秒级时间戳

可选

示例

{
    "listTopiId": "1",
    "pageNo": "1",
    "pageSize": "1",
    "platform": "1",
    "sign": "c4ca4238a0b923820dcc509a6f75849b",
    "timeStamp": 1714061925
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/mt/queryCoupon' \
--header 'Content-Type: application/json' \
--data-raw '{
    "listTopiId": "1",
    "pageNo": "1",
    "pageSize": "1",
    "platform": "1",
    "sign": "c4ca4238a0b923820dcc509a6f75849b",
    "timeStamp": 1714061925
}'

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

data

object

必需

searchId

null

搜索场景出参,用于相同条件下一页请求入参

必需

itemList

array [object {7}]

美团商品集合

必需

hasNext

string

分页使用，看是否有下一页

必需

message

string

必需

示例

{
    "cache": false,
    "code": 0,
    "data": {
        "searchId": null,
        "itemList": [
            {
                "couponValidTimeInfo": {
                    "couponValidSTime": 0,
                    "couponValidTimeType": 1,
                    "couponValidDay": 30,
                    "couponValidETime": 0
                },
                "deliverablePoiInfo": {
                    "lastDeliveryFee": null,
                    "distributionCost": null,
                    "poiName": "麦当劳（北京花园桥外文大厦店）",
                    "deliveryDistance": null,
                    "deliveryDuration": null,
                    "poiLogoUrl": null
                },
                "availablePoiInfo": {
                    "availablePoiNum": 1,
                    "availablePoiCityNum": null
                },
                "purchaseLimitInfo": {
                    "singleDayPurchaseLimit": 3
                },
                "couponPackDetail": {
                    "couponNum": 1,
                    "originalPrice": "2.00",
                    "headUrl": "http://p0.meituan.net/sqs/1abacd9c3cbdfee3950a47a802a29dba5841618.jpg",
                    "specification": null,
                    "sellPrice": "0.18",
                    "saleStatus": true,
                    "recallSource": null,
                    "bizLine": null,
                    "platform": null,
                    "skuViewId": "5XXOUDTN7VCTVSRNX6QOGJHPRU",
                    "saleVolume": "热销70+",
                    "name": "年糕（1串）兑换券",
                    "validTime": 2542440,
                    "startTime": 1740030359,
                    "endTime": 1742572799
                },
                "brandInfo": {
                    "brandName": "彭浦一炸",
                    "brandLogoUrl": "https://img.meituan.net/wdcflow/7f9e8b9a336dc389959afcf2697c22b1113111.jpg"
                },
                "commissionInfo": {
                    "commissionPercent": "600.00",
                    "commission": null
                }
            }
        ],
        "hasNext": "true"
    },
    "message": "操作成功"
}

修改于 2025-03-11 06:25:37

美团到家/到店对接说明

获取美团外卖到家/到店推广链接