​
接口说明

YouTube Works API 获取 YouTube 账号或频道的作品列表。

使用 Pangolinfo API Key 调用，返回结构化 JSON 数据。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/youtube-works

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集最长约75秒，客户端超时建议设为90秒。

​
请求参数

参数必填类型说明
targetYesstring主页链接; 也可直接传频道 id (UC…) 或 @handle
optionsNoobject仅处理下列开放参数；未列出的字段忽略，内部参数不可覆盖。

​
options 参数说明

参数必填类型说明
tabNostring作品 tab, 默认按 URL 或 videos；可选值：videos / shorts / streams / playlists / featured / home
可用值: [“videos”, “shorts”, “streams”, “playlists”, “featured”, “home”]
cursorNostring | null续取作品: 上次输出的 pagination.cursor

仅处理本页列出的请求参数，其他字段忽略。分页游标原样传回，不编码、解码或转换格式。

每次只取一页，用返回游标续取。

​
响应值

返回值类型说明
codeinteger状态码，0 表示成功
messagestring响应信息，成功时为 ok
pointCostnumber本次请求实际消耗的积点
dataobject返回数据，结构见下表
metaobject请求标识及耗时（毫秒）
billingobject计费条数、单价及规则版本

​
返回参数 data 说明

返回值类型说明
typestringType
可用值: [“works”]
worksobject[]作品
paginationobjectPagination

​
data.works[] 字段说明

返回值类型说明
workIdstring | null作品 id (视频 id / 播放列表 id)
videoIdstring | null视频 id; 播放列表为 null
workTypestring作品类型
可用值: [“video”, “short”, “playlist”, “lockup”]
kindstring同 workType
可用值: [“video”, “short”, “playlist”, “lockup”]
urlstring | null链接
titlestring | null标题
thumbnailstring | null封面 (最大尺寸)
coverstring | null封面 (同 thumbnail)
viewsnumber | null播放数 (由文案解析, 如 1.2M → 1200000)
publishTimestring | null发布时间文案, 如 7 days ago; Shorts 没有
durationTextstring | null时长文案, 如 9:18; Shorts 没有
durationSecnumber | null时长 (秒); Shorts 没有
playlistIdstring | null播放列表 id; 视频为 null
contentIdstring | null上游内容 id
contentTypestring | null上游内容类型, 如 LOCKUP_CONTENT_TYPE_VIDEO
channelIdstring | null所属频道 id (推荐视频才有; 频道自己的作品为 null)
channelHandlestring | null所属频道 @handle
channelNamestring | null所属频道名 (推荐视频的第一行文案; 直播预告可能是 “12 waiting”)
accessibilityTextstring | null仅 Shorts: 无障碍描述

​
data.pagination 字段说明

返回值类型说明
cursorstring | null下一页游标, 传回 options.cursor 续取
hasMoreboolean是否还有更多

​
请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/youtube-works \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.youtube.com/@NASA"
}'

​
返回示例

下例截取实际响应中的首条列表记录，长文本与链接作了缩写；pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。

{
  "code": 0,
  "message": "ok",
  "pointCost": 4.0,
  "data": {
    "type": "works",
    "works": [
      {
        "workId": "Zezt6EsG9WE",
        "videoId": "Zezt6EsG9WE",
        "playlistId": null,
        "contentId": "Zezt6EsG9WE",
        "contentType": "LOCKUP_CONTENT_TYPE_VIDEO",
        "workType": "video",
        "kind": "video",
        "url": "https://www.youtube.com/watch?v=Zezt6EsG9WE",
        "title": "NASA Moon Base: Rovers and Lunar Terrain Vehicles (October 2026 Update)",
        "thumbnail": "https://i.ytimg.com/vi/Zezt6EsG9WE/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD89hXnM_XZRxc5qbhG2g_q050geQ",
        "cover": "https://i.ytimg.com/vi/Zezt6EsG9WE/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD89hXnM_XZRxc5qbhG2g_q050geQ",
        "views": 1000000,
        "publishTime": "2 weeks ago",
        "durationText": "9:18",
        "durationSec": 558,
        "channelId": null,
        "channelHandle": null,
        "channelName": null
      }
    ],
    "pagination": {
      "cursor": null,
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-youtube-works-1793954328671605600",
    "durationMs": 5950
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 5,
    "pointCost": 4.0
  }
}

​
积点消耗说明

每条主体结果消耗 0.8 积点。

空结果、失败响应不扣费。同一响应中相同 ID 只计一次，独立调用和续页分别计费。详见 社媒评论 API 计费说明。

在线调试