哼哼猫文档
本页内容

单个帖子(视频/图集/音乐/直播流)提取接口

传入一条帖子链接，返回其中全部媒体（视频、图片、音频、直播流）的下载直链，以及标题、文案、封面、作者等元信息。覆盖哼哼猫支持的 1000+ 社交与视频平台，如 YouTube、TikTok、Instagram、Facebook、Twitter(X)、小红书、B 站、微博等；youtu.be、vt.tiktok.com 这类短链接也可以直接传。

🎯 基本信息

项目内容
接口地址https://api.meowload.net/openapi/v1/extract/post
请求方式POST，请求体为 JSON
鉴权请求头 Authorization: Bearer <你的 API Key>，Key 在 开发者管理中心 获取
计费仅成功（200）时扣次数，规则见 开发者管理中心

第一次接入可先看 快速开始。

📋 请求参数

参数类型必填说明
urlstring是帖子链接，短链接可直接传

错误消息默认为英文，需要中文时加请求头 Accept-Language: zh。

请求示例

curl -X POST https://api.meowload.net/openapi/v1/extract/post \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

🟢 成功响应

响应示例

HTTP 状态码为 200，响应体就是提取结果。下面的示例经过裁剪，只保留最常用的字段：

{
  "site": "youtube",
  "title": "Scenic tour of the Karst mountains",
  "text": "A drone flight over the Karst mountains at sunrise. Filmed in 4K.",
  "medias": [
    {
      "media_type": "video",
      "resource_url": "https://video.example.com/v/EXAMPLE0001/360p.mp4?expire=1700000000&sig=EXAMPLE",
      "preview_url": "https://images.example.com/EXAMPLE0001/cover.jpg",
      "duration": 55,
      "headers": { "Referer": "https://www.example.com/" },
      "variants": [
        {
          "quality": 1080,
          "quality_label": "1080p",
          "video_url": "https://video.example.com/v/EXAMPLE0001/1080p.mp4?expire=1700000000&sig=EXAMPLE",
          "video_ext": "mp4",
          "video_filesize": 25051752,
          "audio_url": "https://video.example.com/v/EXAMPLE0001/audio-en.m4a?expire=1700000000&sig=EXAMPLE",
          "audio_ext": "m4a",
          "audio_filesize": 887229,
          "is_default": true
        },
        {
          "quality": 360,
          "quality_label": "360p",
          "video_url": "https://video.example.com/v/EXAMPLE0001/360p.mp4?expire=1700000000&sig=EXAMPLE",
          "video_ext": "mp4",
          "video_filesize": 3742315
        }
      ]
    }
  ],
  "id": "EXAMPLE0001",
  "post_url": "https://www.youtube.com/watch?v=EXAMPLE0001",
  "created_at": "2025-06-02T12:00:00.000Z",
  "author": { "username": "@travelchannel", "display_name": "Travel Channel" }
}

响应字段说明

  • medias[] 是这条帖子的全部媒体。media_type 区分 video、image、audio、live、file，resource_url 是可直接下载的地址。
  • 视频有多个清晰度时给出 variants[]。quality 是高度像素（9999 表示原画），quality_label 是展示用标注，is_default 为 true 的那档是推荐档；一个变体同时有 video_url 与 audio_url 表示音视频分离，需要各自下载后合并。
  • 媒体直链是短效的，请拿到后尽快下载。媒体带 headers 时，下载请求要原样带上这些请求头，否则会被平台拒绝。
  • 没有值的字段整个省略，不会给 null 或空串。title 与 text 都可能缺省，展示用文案可取 title || text。

完整参数与响应字段见 API 参考。

🔴 错误响应

提取失败返回 HTTP 400，不扣次数，响应体带机器可读的 code 与 retryable（稍后重试同一链接是否可能成功）：

{ "message": "该内容已被删除或不存在", "code": "content_deleted", "retryable": false }

401（API Key 无效）、402（次数用尽）、422（请求体不合法）、429（触发限流）与全部提取错误码的处理方式见 错误码。