YouTube Music Albums Scraper
Pricing
from $2.99 / 1,000 albums
YouTube Music Albums Scraper
Search current YouTube Music album results and retrieve rich album and optional track metadata through YouTube Music's first-party youtubei endpoints.
YouTube Music Albums Scraper
Pricing
from $2.99 / 1,000 albums
Search current YouTube Music album results and retrieve rich album and optional track metadata through YouTube Music's first-party youtubei endpoints.
recordType
Optional
Normal dataset record discriminator.
searchQuery
Optional
Search query that produced this album candidate, when the source was a search.
browseId
Optional
YouTube playlist or Music album browse identifier.
title
Optional
Album or playlist title visible on the public page.
albumType
Optional
Conservative classification derived from public album or playlist metadata.
contentType
Optional
Source-provided content type when the public search result exposes it.
isOfficialAlbum
Optional
Whether the public data contains explicit official-album evidence.
sourceKind
Optional
Source classification for the record.
classificationEvidence
Optional
Public renderer or identifier evidence used for the source classification.
artist
Optional
Artist or playlist owner text visible on the source page.
creatorName
Optional
Public playlist owner or channel name.
creatorId
Optional
Public YouTube channel identifier for the creator, when exposed.
creatorUrl
Optional
Public YouTube channel URL for the creator.
year
Optional
Release year copied from explicit official release metadata; not inferred from a title.
releaseYear
Optional
Explicit official release year exposed by the public Music album page.
releaseDate
Optional
Explicit official release date text exposed by the public Music album page.
titleYearHint
Optional
Year-looking text found in the title; retained as a hint and never promoted to releaseYear.
releaseMetadataSource
Optional
Provenance label for release metadata or the absence of verified official metadata.
albumUrl
Optional
Canonical public YouTube playlist or Music album URL.
musicUrl
Optional
Public YouTube Music URL for the playlist or album.
description
Optional
Description text visible on the public album or playlist page.
descriptionLength
Optional
Character count of the normalized description.
releaseMetadata
Optional
Normalized public metadata and statistics text retained for reconciliation.
totalTrackCount
Optional
Track count reported by the public page, when present.
totalTrackCountText
Optional
Original normalized public track-count text.
totalViewCount
Optional
View count reported by the public page, when present.
totalViewCountText
Optional
Original normalized public view-count text.
updatedText
Optional
Public last-updated text, when exposed.
thumbnailUrl
Optional
Largest normalized public album thumbnail URL exposed by the page.
thumbnailCount
Optional
Number of distinct public album thumbnails retained.
thumbnails
Optional
Distinct public album thumbnails with source dimensions when exposed.
[ { "url": "https://i.ytimg.com/vi/example/hqdefault.jpg", "width": 480, "height": 360 }]trackCount
Optional
Number of visible track records retained after maxTracks is applied.
rawTrackCount
Optional
Number of distinct track renderers seen on the initial public page before the maxTracks cap.
tracks
Optional
Bounded visible track metadata from the public playlist page.
initialItemsExposed
Optional
Number of track renderer instances exposed on the initial page.
continuationDetected
Optional
Whether the public page exposed continuation metadata.
continuationCount
Optional
Bounded count of continuation markers observed; continuation requests are not replayed.
source
Optional
Input source type that produced this record.
sourceUrl
Optional
Public search or playlist URL associated with this record.
searchUrl
Optional
Public search URL used to find this record, for search-sourced rows only.
rank
Optional
Rank of the candidate within its source page.
page
Optional
Public page number represented by this record. This Actor currently uses the initial page only.
sourceRenderer
Optional
Public renderer family used for the album candidate.
sourceTransport
Optional
Public HTML transport used for the source page.
extractionMethod
Optional
Bounded extraction method used for public embedded page data.
metadataSource
Optional
Public page source for the enriched album metadata.
metadataEnriched
Optional
Whether the public detail page was fetched and merged into the record.
albumPageAvailable
Optional
Whether a public album or playlist detail page was successfully parsed.
requestedMaxItems
Optional
Global maxItems value used for the run.
requestedMaxSearchItems
Optional
Per-search maxSearchItems value used for the run.
requestedMaxStartItems
Optional
Direct-URL maxStartItems value used for the run.
requestedMaxPages
Optional
Configured page bound recorded for the run; continuation pages are not requested.
requestedMaxTracks
Optional
Per-record maxTracks value used for the run.
includeTracks
Optional
Whether visible track rows were retained.
languageCode
Optional
Lowercase language context used for public page URLs and headers.
countryCode
Optional
Uppercase two-letter country context used for public page URLs and headers.
scrapedAt
Optional
UTC timestamp when the dataset row was emitted.
url
Optional
Public URL associated with a diagnostic record.
error
Optional
Sanitized diagnostic message explaining a blocked, empty, or failed public page operation.
errorCode
Optional
Stable diagnostic category. Diagnostic rows contain only url, error, errorCode, and scrapedAt.