​
API Description

YouTube Works API — Collect works published by a YouTube account or channel.

Authenticate with your Pangolinfo API Key to receive structured JSON data.

​
Request URL

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

​
Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.

​
Request Parameters

ParameterRequiredTypeDescription
targetYesstringTarget URL, supported ID or search keyword for this operation.
optionsNoobjectOptional collection settings, described below.

​
options Parameters

ParameterRequiredTypeDescription
tabNostringProfile or channel tab to collect.
Values: [“videos”, “shorts”, “streams”, “playlists”, “featured”, “home”]
cursorNostring | nullContinuation cursor from the previous response. Pass the value unchanged.

Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.

Each request collects one page. Continue with the returned cursor.

​
Response Fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success.
messagestringResponse message; ok on success.
pointCostnumberPoints charged for this request.
dataobjectCollected data, with fields described below.
metaobjectRequest identifier and duration in milliseconds.
billingobjectCharged units, unit price and billing rule version.

​
data Fields

FieldTypeDescription
typestringResult type.
worksobject[]Collected works.
paginationobjectContinuation cursor and whether more results are available.

​
data.works[] Fields

FieldTypeDescription
workIdstring | nullWork id
videoIdstring | nullVideo id
workTypestringWork type
Values: [“video”, “short”, “playlist”, “lockup”]
kindstringKind
Values: [“video”, “short”, “playlist”, “lockup”]
urlstring | nullContent URL.
titlestring | nullTitle
thumbnailstring | nullThumbnail
coverstring | nullCover
viewsnumber | nullView count.
publishTimestring | nullPublish time
durationTextstring | nullDuration text
durationSecnumber | nullDuration sec
playlistIdstring | nullPlaylist id
contentIdstring | nullContent id
contentTypestring | nullContent type
channelIdstring | nullChannel id
channelHandlestring | nullChannel handle
channelNamestring | nullChannel name
accessibilityTextstring | nullAccessibility text

​
data.pagination Fields

FieldTypeDescription
cursorstring | nullContinuation cursor from the previous response. Pass the value unchanged.
hasMorebooleanWhether more results are available.

​
Request Example

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"
}'

​
Response Example

This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.

{
  "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
  }
}

​
Points Usage

0.8 points per primary result.

Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.

Try it