API Description

YouTube Home API — Collect YouTube profile information and first-page works.

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

Request URL

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

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”]
includeAboutNobooleanInclude the channel About panel. Default: true.
includeFeaturedNobooleanInclude featured trailer, channels and shelves. Default: false; requires one extra collection request.

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

Includes first-page works. Use the works operation, where available, to continue.

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.
profileobjectProfile details.
worksobject[]Collected works.
paginationobjectContinuation cursor and whether more results are available.

data.profile Fields

FieldTypeDescription
avatarstring | nullAvatar URL.
nicknamestring | nullAuthor display name.
handlestring | nullHandle
accountIdstring | nullAccount id
channelIdstring | nullChannel id
profileUrlstringAuthor profile URL.
verifiedbooleanVerified
subscribernumber | nullSubscriber
videosnumber | nullVideos
playnumber | nullPlay
introTextstring | nullIntro text
biostring | nullBio
countrystring | nullCountry
registerTimeobjectRegister time
linksobject[]Links
externalLinksstring[]External links
businessEmailstring | nullBusiness email
contactEmailstring | nullContact email
businessEmailRequiresLoginboolean | nullBusiness email requires login
keywordsstring | nullKeywords
familySafeboolean | nullFamily safe
unlistedboolean | nullUnlisted
bannerobject[]Banner
tabsobject[]Tabs
hasPodcastsbooleanHas podcasts
featuredobject | nullFeatured
targetUrlstringTarget url
tabstringProfile or channel tab to collect.

data.profile.registerTime Fields

FieldTypeDescription
textstring | nullText value.
timestampnumber | nullTimestamp

data.profile.links[] Fields

FieldTypeDescription
titlestring | nullTitle
urlstring | nullContent URL.
faviconstring | nullFavicon

data.profile.banner[] Fields

FieldTypeDescription
urlstringContent URL.
widthnumberWidth
heightnumberHeight

data.profile.tabs[] Fields

FieldTypeDescription
titlestring | nullTitle
urlstring | nullContent URL.
FieldTypeDescription
trailerobject | nullTrailer
channelsobject[]Channels
shelvesobject[]Shelves

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-home \
  --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": 0.8,
  "data": {
    "type": "home",
    "profile": {
      "avatar": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s160-c-k-c0x00ffffff-no-rj",
      "nickname": "NASA",
      "handle": "@NASA",
      "accountId": "UCLA_DiR1FfKNvjuUpBHmylQ",
      "channelId": "UCLA_DiR1FfKNvjuUpBHmylQ",
      "profileUrl": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
      "verified": false,
      "subscriber": 15100000,
      "videos": 6197,
      "play": 1134128588,
      "introText": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research.\r\n\r\nTo do that, we have worked around the world—...",
      "bio": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research.\r\n\r\nTo do that, we have worked around the world—...",
      "country": null,
      "registerTime": {
        "text": "Joined Jun 3, 2008",
        "timestamp": 1212451200000
      },
      "links": [
        {
          "title": "nasa.gov",
          "url": "https://www.nasa.gov",
          "favicon": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSEKV8ZD6yVWabVEXRkx3en2yMjBGOWYRwKz_2GeVQL8u7Z_wXyXxdXJOcDzImKp4wMt3pvXoHEtR1VRjHwEpxQgJiowW_JG9Mq..."
        }
      ],
      "externalLinks": [
        "https://www.nasa.gov"
      ],
      "businessEmail": null,
      "contactEmail": null,
      "businessEmailRequiresLogin": false,
      "keywords": "nasa space iss shuttle 50th astronauts planets earth rockets hubble telescopes NASA TV galaxy apollo gemini mercury sta Moon Artemis \"solar system\"",
      "familySafe": true,
      "unlisted": false,
      "banner": [
        {
          "url": "https://yt3.googleusercontent.com/y8Srh-oCcilLvBO8jAPI546m1bn0puA5DIvQiBZ1cSxc_rZfKxKSFlTCtoCQCtB6viUf1NGsaQ=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-n...",
          "width": 1060,
          "height": 175
        }
      ],
      "tabs": [
        {
          "title": "Home",
          "url": "https://www.youtube.com/@NASA/featured"
        }
      ],
      "hasPodcasts": true,
      "targetUrl": "https://www.youtube.com/@NASA",
      "tab": "videos"
    },
    "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-home-1793954295679869400",
    "durationMs": 25011
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 1,
    "pointCost": 0.8
  }
}

Points Usage

0.8 points per profile. Included works are free.

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