# 列表页提取

> 按页提取播放列表、频道、博主主页与话题（hashtag）

来源: https://platform.snapany.com/zh/docs/extract-playlist

[`POST /openapi/v1/extract/playlist`](https://platform.snapany.com/zh/docs/api#POST/extract/playlist) — 每页消耗 2 积分。

从播放列表 / 频道 / 博主主页 / 话题（hashtag）链接提取一页帖子，用 cursor 翻页：

```bash
# 第一页
curl -X POST https://api.snapany.com/openapi/v1/extract/playlist \
  -H "Authorization: Bearer sk_snapany_xxx" \
  -H "Accept-Language: zh" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@nasa/videos"}'

# 下一页：传上一次返回的 cursor
curl -X POST https://api.snapany.com/openapi/v1/extract/playlist \
  -H "Authorization: Bearer sk_snapany_xxx" \
  -H "Accept-Language: zh" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@nasa/videos", "cursor": "..."}'
```

响应中没有下一页 cursor 时即为最后一页。

每一页的响应内容：

- **posts**：一页帖子，每个帖子与单个帖子提取接口**同构**——媒体直链、清晰度变体、字幕、统计数据、作者信息都在，无需再逐条调用单帖接口
- **profile**：页面主体（频道 / 博主 / 话题）的昵称、头像、粉丝数、简介
- **has_more / next_cursor**：翻页游标

完整字段结构与真实响应示例见 [API 参考](https://platform.snapany.com/zh/docs/api#POST/extract/playlist)。

## 支持的网站

YouTube（频道、播放列表、Shorts、Hashtag）、TikTok（博主主页、Hashtag）、Instagram（博主主页、Hashtag）、X/Twitter（博主主页）、抖音（博主主页、合集）、哔哩哔哩（UP 主主页、合集）、微博（博主主页）、今日头条 / 西瓜视频（博主主页）、好看视频（博主主页）等 50+ 网站。