参数名	类型	必填	说明
key	string	是	接口调用密钥
action	string	否	接口动作；可选值为 health、device、sign、encrypt、decrypt、derive_key、client_pub、build_request、call、feed_recommend、feed_nearby、audio_feed、audio_url、location；默认 health
data	string	否	待签名文本或 Base64 字符串
data_is_b64	boolean	否	为 true 时先对 data 做 Base64 解码
plaintext	string	否	待加密明文，与 json 二选一
json	object	否	待加密 JSON 对象，与 plaintext 二选一
nonce	string	否	4 字节十六进制随机数，例如 76553dd9
blob	string	否	MOMO 加密数据，默认 Base64
blob_is_b64	boolean	否	为 false 时 blob 按十六进制解析
server_pk	string	否	secp192k1 服务端公钥，未提供时使用内置公钥
client_priv	string	否	客户端私钥十六进制值，未提供时随机生成
client_priv	string	否	客户端私钥十六进制值，未提供时随机生成
url	string	否	目标接口 URL
body	object	否	目标接口业务请求体
lat	string	否	本次请求纬度，不保存
lng	string	否	本次请求经度，不保存
url	string	否	目标接口 URL
body	object	否	目标接口业务请求体
encrypt	boolean	否	是否使用 mzip 加密请求体，默认 true
lat	string	否	本次请求纬度，不保存
lng	string	否	本次请求经度，不保存
count	string	否	返回数量，默认 20
type	string	否	流类型，默认 FEED
universeVersion	string	否	宇宙接口版本，默认 4
lat	string	否	本次请求纬度，不保存
lng	string	否	本次请求经度，不保存
type	string	否	附近流类型，默认 1
count	string	否	返回数量，默认 20
source	string	否	数据来源，默认 nearby-feed
lat	string	否	本次请求纬度，不保存
lng	string	否	本次请求经度，不保存
count	string	否	返回数量，默认 20
type	string	否	流类型，默认 AUDIO
universeVersion	string	否	宇宙接口版本，默认 4
lat	string	否	本次请求纬度，不保存
lng	string	否	本次请求经度，不保存
item	string	否	完整 feed item、audioFeedVo 对象或 guid
guid	string	否	音频 guid，和 item 二选一

陌陌-推荐

接口说明

该接口用于获取陌陌小宇宙首页的推荐动态流，适用于需要拉取推荐内容的客户端或应用。返回结果包含用户动态、互动数据及关联广告等完整推荐列表。

调用地址

https://api.vsaa.cn/api/momo/index.php

请求方式

本接口支持 GET 与 POST 两种请求方式。GET 请求将所有参数通过 URL 查询字符串传递；POST 请求可将参数置于请求体中传输。两种方式在业务行为上无差异，开发者可根据自身技术栈与参数长度选择适配方式。

鉴权说明

调用本接口必须提供密钥。密钥通过 Query 参数 key 传递，为每次请求的必填项。若请求中缺失 key 参数或密钥无效，服务端将拒绝访问并返回鉴权失败状态。密钥为唯一鉴权凭据，无需额外传递其他认证头或签名参数。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥。
action	string	否	指定执行的接口动作。可选值：`health`（默认）、`device`、`sign`、`encrypt`、`decrypt`、`derive_key`、`client_pub`、`build_request`、`call`、`feed_recommend`、`feed_nearby`、`audio_feed`、`audio_url`、`location`。
data	string	否	待签名文本或 Base64 字符串，需配合 `sign` 或相关动作使用。
data_is_b64	boolean	否	标识 `data` 是否为 Base64 编码。设为 `true` 时先解码再处理，默认 `false`。
plaintext	string	否	待加密的明文内容。与 `json` 参数二选一，用于加密动作。
json	object	否	待加密的 JSON 对象。与 `plaintext` 参数二选一，用于加密动作。
nonce	string	否	4 字节十六进制随机数，例如 `76553dd9`。
blob	string	否	MOMO 加密数据块。默认按 Base64 解析。
blob_is_b64	boolean	否	标识 `blob` 的解析方式。设为 `false` 时按十六进制解析，默认 `true`。
server_pk	string	否	secp192k1 算法的服务端公钥。未提供时使用内置公钥。
client_priv	string	否	客户端私钥的十六进制值。未提供时随机生成。
url	string	否	目标接口 URL。
body	object	否	目标接口的业务请求体。
lat	string	否	本次请求的纬度，仅用于当前请求定位，不保存。
lng	string	否	本次请求的经度，仅用于当前请求定位，不保存。
encrypt	boolean	否	是否使用 mzip 加密请求体，默认 `true`。
count	string	否	返回的数据条数，默认 `20`。
type	string	否	流类型。在推荐动作中默认 `FEED`，在附近动作中默认 `1`，在音频动作中默认 `AUDIO`。
source	string	否	数据来源，默认 `nearby-feed`。
universeVersion	string	否	宇宙接口版本，默认 `4`。
item	string	否	完整的 feed item、audioFeedVo 对象或 guid，用于获取音频 URL 等特定动作。
guid	string	否	音频 guid。与 `item` 参数二选一，用于音频相关动作。

成功响应示例

{
  "ec": 0,
  "em": "success",
  "errcode": 0,
  "errmsg": "success",
  "timesec": 1792268457,
  "data": {
    "count": 20,
    "index": 0,
    "total": 0,
    "lists": [
      {
        "theme": 0,
        "source": {
          "feedid": "900238348_dxlJX39zUhsABg==",
          "userId": "dxlJX39zUhsABg==",
          "createTime": 1792199746,
          "createTimeFormat": "19小时前",
          "content": "一觉醒来下雨了，裹紧被子接着睡",
          "commentNum": 23,
          "likeNum": 2,
          "lightNum": 1,
          "userVo": {
            "name": "乐观星U-897",
            "photo": "https://img.momocdn.com/banner/AE/54/AE542FB0-5FB7-D436-749B-4E4208778F7220210223.png",
            "sex": "M"
          },
          "feedTypeEnum": "TEXT",
          "postStatusEnum": "NORMAL",
          "recType": "hot"
        },
        "logid": "microcosmhome:6ca0fbb631054a8f8d6da682532f48eb:900238348_dxlJX39zUhsABg==:dxlJX39zUhsABg==:0",
        "logmap": {
          "index": 0,
          "rec_reason": "high_conversion_recall_hourly",
          "ele_wave_type": "TEXT",
          "rec_type": "hot",
          "status": 1
        }
      },
      {
        "theme": 16,
        "source": {
          "id": "1184469167_1792268457331_8",
          "content": "京东双11大促大牌护肤神仙水肌感清爽，好吸收",
          "source": "最近发布",
          "adStyle": 1,
          "basicInfo": {
            "name": "京东秒杀",
            "uniformLabels": {
              "list": [
                {
                  "text": "广告"
                }
              ]
            }
          },
          "feedid": "1184469167_1792268457331_8"
        },
        "logid": "fixed:1184469167:1a14b8654a385b46207eb17405323bc:1792268457483:16:7",
        "logmap": {
          "index": 7,
          "biz": "ad",
          "seat": 8,
          "fixedInsert": "1"
        }
      }
    ],
    "remain": 1,
    "user": {
      "userId": "cRdJU3x1VhABBg==",
      "name": "勇敢星H-87",
      "photo": "https://img.momocdn.com/banner/85/D9/85D92243-8A98-484E-AE66-6D1D7BEFC5AB20210223.png",
      "sex": "M",
      "starNum": 40
    },
    "requestId": "6ca0fbb631054a8f8d6da682532f48eb",
    "blockNewest": 1,
    "personalNewStrategy": false
  },
  "videoUrls": []
}

响应字段说明

字段路径	类型	说明
`ec`	integer	状态码。`0` 表示请求成功，非 `0` 表示发生错误。
`em`	string	状态描述信息。成功时为 `"success"`。
`errcode`	integer	兼容旧版接口的状态码，成功时为 `0`。
`errmsg`	string	兼容旧版接口的状态描述，成功时为 `"success"`。
`timesec`	integer	服务端当前时间戳（秒级 Unix 时间）。
`data`	object	核心业务数据对象。
`data.count`	integer	本次请求配置的返回数量上限。
`data.index`	integer	当前列表起始索引，通常从 `0` 开始。
`data.total`	integer	总条目数。部分动态流接口此值可能为 `0` 或不参与分页逻辑。
`data.lists`	array	推荐内容列表数组，包含用户动态及广告位。
`data.lists[].theme`	integer	卡片主题样式标识。`0` 为普通用户动态，非 `0`（如 `16`）通常为广告或特殊样式卡片。
`data.lists[].source`	object	卡片具体内容数据。根据 `theme` 不同，结构有所差异。
`data.lists[].source.feedid`	string	动态唯一标识（UUID 或复合 ID）。
`data.lists[].source.userId`	string	发布者的用户 ID。
`data.lists[].source.createTime`	integer	动态发布时间戳（秒级）。
`data

错误响应示例

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

业务错误码说明

errcode	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足
11025	该密钥无权调用此接口

调用示例

终端 curl（bash）

获取推荐动态流，通过 Query 参数传递密钥：

curl -G "https://api.vsaa.cn/api/momo/index.php" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=feed_recommend" \
  --data-urlencode "count=10"

PHP

// PHP 示例：使用 cURL 获取推荐动态流

function getMomoFeed() {
    $url = "https://api.vsaa.cn/api/momo/index.php";
    $params = [
        'key' => 'YOUR_API_KEY',
        'action' => 'feed_recommend',
        'count' => 10
    ];

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPGET, true);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 200) {
        return null;
    }

    return json_decode($response, true);
}

$result = getMomoFeed();
if ($result && $result['ec'] === 0) {
    foreach ($result['data']['lists'] as $item) {
        echo "Content: " . $item['source']['content'] . "\n";
    }
}

注意事项

密钥安全：接口调用密钥（key）是访问的唯一凭证，请务必妥善保管。严禁将密钥硬编码在前端代码、移动应用或公开的版本控制系统中，仅应在服务端使用，通过服务端接口中转调用，避免密钥泄露导致资源被盗用或异常消耗。
鉴权方式：本接口仅支持通过 URL Query 参数 key 传递密钥。请勿尝试使用 HTTP 头部（Header）或其他任何非 Query 方式的密钥传递方法，否则请求将被拒绝。
频率限制：接口每分钟允许调用次数约为 60 次。请在业务逻辑中实现请求节流或排队机制，避免突发高频请求触发限流导致服务不可用或密钥被临时封禁。
HTTPS 强制：必须使用 HTTPS 协议（https://api.vsaa.cn）进行调用，不支持 HTTP 明文传输，以确保数据在传输过程中的安全性。
参数完整性：调用推荐流功能时，需正确指定 action 为 feed_recommend 等对应动作。若使用虚拟定位功能，lat 和 lng 参数仅对当次请求生效，不会持久化保存；且坐标格式需符合标准经纬度规范，无效坐标可能导致请求失败或返回数据异常。
数据解析：返回的 data.lists 中包含多种内容类型（如普通动态、广告等），业务解析时应区分 theme 字段，避免将广告数据误作普通用户动态处理；部分字段（如 detailGoto）包含嵌套 JSON 字符串，使用时需二次解析。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

陌陌-推荐

接口信息

请求参数

返回示例

详细文档

陌陌-推荐

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

看图猜成语