批量提取接口：主页、播放列表、频道采集 API

传入一个主页链接——博主或频道主页、播放列表、合集、Hashtag 或话题页——按页返回其中的帖子列表，并附上主页本身的资料（名称、头像、粉丝数等）。每条帖子的结构与单个帖子提取接口一致，拿返回的 next_cursor 逐页翻下去就能取完整个主页。哼哼猫「主页批量提取」支持的平台本接口都支持，如 YouTube（频道页、Shorts、Hashtag、播放列表）、Instagram（作者主页、Hashtag）、Twitter(X)、TikTok（作者主页、Hashtag）、D（主页、合集）、B 站（主页、合集）、微博等。

🎯 基本信息

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

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

📋 请求参数

参数	类型	必填	说明
`url`	string	是	主页链接（频道、播放列表、话题等）
`cursor`	string	-	分页游标，第一页不传，后续页传上一页返回的 `next_cursor`

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

请求示例

# 第一页
curl -X POST https://api.meowload.net/openapi/v1/extract/playlist \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{"url": "https://www.youtube.com/@Nike/videos"}'

# 第二页：把上一页返回的 next_cursor 作为 cursor 传入
curl -X POST https://api.meowload.net/openapi/v1/extract/playlist \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{"url": "https://www.youtube.com/@Nike/videos", "cursor": "4qmFsgKRARIYVUNzQlZQMWpGeU1CQ21Za2xaeXhpVEE0"}'

🟢 成功响应

响应示例

HTTP 状态码为 200，响应体是当前这一页的内容。下面的示例经过裁剪，只保留最常用的字段：

{
  "site": "youtube",
  "posts": [
    {
      "id": "EXAMPLE0002",
      "title": "Top plays of the week",
      "post_url": "https://www.youtube.com/watch?v=EXAMPLE0002",
      "created_at": "2025-07-20T08:00:00.000Z",
      "medias": [
        {
          "media_type": "video",
          "resource_url": "https://video.example.com/v/EXAMPLE0002/720p.mp4?expire=1700000000&sig=EXAMPLE",
          "preview_url": "https://images.example.com/EXAMPLE0002/cover.jpg",
          "duration": 128
        }
      ]
    },
    {
      "id": "EXAMPLE0003",
      "title": "Behind the scenes",
      "post_url": "https://www.youtube.com/watch?v=EXAMPLE0003",
      "created_at": "2025-07-18T15:30:00.000Z",
      "medias": [{ "media_type": "image", "resource_url": "https://images.example.com/EXAMPLE0003/cover.jpg" }]
    }
  ],
  "next_cursor": "4qmFsgKRARIYVUNzQlZQMWpGeU1CQ21Za2xaeXhpVEE0",
  "has_more": true,
  "profile": {
    "username": "@techchannel",
    "display_name": "Tech Channel",
    "avatar_url": "https://images.example.com/channel/avatar.jpg",
    "post_count": 342
  }
}

响应字段说明

posts[] 是当前页的帖子，每条与单个帖子接口的响应同构：medias[]、title、text、author 等字段都可能出现，视频同样可能带 variants[] 与 headers。
has_more 为 true 时，把 next_cursor 原样作为下一次请求的 cursor 传入即可取下一页；为 false 表示已到末页，此时 next_cursor 为空串。游标是不透明字符串，不要解析或拼接。
profile 是这个主页的主体（频道、博主或话题）的资料，site 是链接所属的平台。
created_at 是可选字符串：准确时刻为 UTC ISO 8601（以 Z 结尾，保留毫秒，如 2026-10-06T13:37:04.123Z）；平台只提供相对时间时返回原文（如 3 days ago）；两者都没有时省略。只有 ISO 值可用于日期排序、筛选和时区转换，相对文案应原样展示，不按当前时间倒推。
同样的规则适用于 posts[].created_at、各帖的媒体与作者，以及 profile.created_at。帖子、媒体、账号的时间分别表示发布时间、媒体创建时间和账号注册时间，各自保留，不互相覆盖。
媒体直链是短效的，请拿到后尽快下载。媒体带 headers 时，下载请求要原样带上这些请求头，否则会被平台拒绝。

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

🔴 错误响应

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

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

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