YouTube Playlist Export (Data API), No Login avatar

YouTube Playlist Export (Data API), No Login

Pricing

from $0.21 / 1,000 playlist videos

Go to Apify Store
YouTube Playlist Export (Data API), No Login

YouTube Playlist Export (Data API), No Login

Export every video of a YouTube playlist to CSV, Excel or JSON: position, title, channel, date, duration, views and likes. Up to 20,000 videos per playlist. Official Data API with your own free key. No login.

Pricing

from $0.21 / 1,000 playlist videos

Rating

0.0

(0)

Developer

Cliqto Media

Cliqto Media

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

4 days ago

Last modified

Categories

Features

Limited permissions

Share

YouTube Playlist Export turns public YouTube playlists into a table: one row per playlist position, with the video title, channel, publish date, duration, views, likes, comments and link. You paste playlist links or IDs and add your own free YouTube Data API v3 key, and you get the whole playlist in the same order as on YouTube. The price is $0.30 per 1,000 videos on the Free plan.

The Actor uses only the official YouTube Data API v3: no login, no cookies, no proxy and no page scraping. You need an API key. Without a key the run returns one api_key_required row and stops. Getting a key is free and takes about 5 minutes (how).

YouTube Playlist Export: paste a playlist link and your API key, get one row per playlist position with title, duration, views and publish date. Private videos keep their position and are marked unavailable. Official Data API, up to 20,000 videos per playlist.

Table of contents

What it does

You give one or more playlists. For each playlist the Actor reads the playlist name and owner, then walks the playlist 50 entries at a time and saves one row per entry:

  • position is the place in the playlist, starting at 1, exactly as in the YouTube player.
  • A private or deleted video keeps its position. Its row has status unavailable and unavailableReason (private or deleted), so there are no holes and no renumbering.
  • With Include duration and view/like/comment counts on (the default), each row also has durationSec, views, likes and comments.
  • null means "no value from YouTube" (for example, hidden likes). It is never written as 0.
  • Accepted inputs: youtube.com/playlist?list=…, a watch link with &list=…, youtu.be/…?list=…, music.youtube.com playlist links, m.youtube.com links, or bare playlist IDs (PL…, UU…, OL… and others). The same playlist given twice is exported once.
  • A channel's uploads playlist works too: take the channel ID UC… and change the first two letters to UU. If you paste a channel link, the row tells you this ID.

Good fit

  • You need the full list of videos of a course, podcast, music or tutorial playlist in a sheet.
  • You audit or catalog many playlists and need exact positions and numbers.
  • You want an official, stable data source with a clear quota.

Not a fit

  • You have no API key and do not want one. This Actor does not work without a key.
  • Watch later and Liked videos (WL, LL) and private playlists. Google gives them only to their owner after a sign-in, never with an API key.
  • Comments, transcripts or search results. See Related Actors.

Get your API key

The key is free.

  1. Open the Google Cloud Console and make or pick a project.
  2. Go to APIs & Services → Library, find YouTube Data API v3 and click Enable.
  3. Go to APIs & Services → Credentials → Create credentials → API key.
  4. Copy the key into the YouTube Data API key field of this Actor.

Tip: in the key settings, limit the key to YouTube Data API v3 only.

Quota cost for you. Google gives each project 10,000 quota units per day for free. Every request of this Actor costs 1 unit:

  • 1 unit per 50 playlist entries;
  • 1 more unit per 50 videos when Include duration and view/like/comment counts is on;
  • 1 unit per run for the playlist names (up to 50 playlists).
Videos in a runQuota units with countsWithout countsShare of the free daily quota (with counts)
10 (the prefill)320.03%
200950.09%
1,00041210.4%
20,0008014018%

The quota resets at midnight Pacific Time. You can see your usage in Google Cloud Console → APIs & Services → YouTube Data API v3 → Quotas. Google does not charge money for this quota. See the Google quota page.

The key is a secret field: Apify stores it encrypted. The Actor sends it only to Google, in a request header. It never writes the key to the dataset, the logs or the run summary, and it removes it from any error text.

Quick start

  1. Get a key (see above).
  2. The Playlist URLs or IDs field already has one example playlist, and Max videos per playlist is set to 10.
  3. Paste your key into YouTube Data API key.
  4. Click Start. Ten videos take a few seconds.
  5. Open the Videos view of the dataset, or download it as CSV, Excel or JSON.

To export whole playlists, set Max videos per playlist higher (the default is 200, the maximum is 20,000).

If you click Start without a key, the run still ends as SUCCEEDED, with one api_key_required row that tells you how to get a key. Nothing is fetched and no video is charged. Apify charges the Actor start fee for every run, including this one (see Pricing).

Input

FieldTypeRequiredDefaultRangeWhat it does
playlistUrlsarray of stringsyesprefill: 1 example playlist1–100 playlistsPlaylist links or IDs, one per line. The same playlist twice is exported once.
apiKeystring, secretyes, for real datanone—Your YouTube Data API v3 key. Without it you get one api_key_required row.
maxItemsintegerno200 (prefill 10)1–20,000Stop each playlist after this many entries. Private and deleted entries count too.
includeStatsbooleannotrue—Fill durationSec, duration, views, likes, comments. Costs 1 more quota unit per 50 videos. The Apify price is the same.

maxItems works per playlist: with 3 playlists and maxItems 100 you get up to 300 rows.

Input examples

One playlist, first 10 videos (the prefill plus your key)

{
"playlistUrls": ["https://www.youtube.com/playlist?list=PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH"],
"maxItems": 10,
"apiKey": "YOUR_API_KEY"
}

Whole playlists, titles and dates only (half the quota)

{
"playlistUrls": [
"PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH",
"https://www.youtube.com/watch?v=17WoOqgXsRM&list=PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH",
"https://music.youtube.com/playlist?list=PL8F6B0753B2CCA128"
],
"maxItems": 20000,
"includeStats": false,
"apiKey": "YOUR_API_KEY"
}

The second line is the same playlist as the first, so it is exported once.

Output example

A real row (the description is cut here):

{
"status": "ok",
"playlistId": "PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH",
"playlistTitle": "Coding Challenges",
"playlistChannelTitle": "The Coding Train",
"playlistUrl": "https://www.youtube.com/playlist?list=PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH",
"position": 1,
"videoId": "17WoOqgXsRM",
"url": "https://www.youtube.com/watch?v=17WoOqgXsRM&list=PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH",
"title": "Coding Challenge 1: Starfield Simulation",
"description": "This is the first in a new series of vid…",
"channelTitle": "The Coding Train",
"channelId": "UCvjgXvBlbQiydffZU7m1_aw",
"publishedAt": "2016-04-13T03:17:50Z",
"addedAt": "2016-04-13T03:17:51Z",
"durationSec": 834,
"duration": "PT13M54S",
"views": 1389218,
"likes": 29580,
"comments": 1386,
"thumbnailUrl": "https://i.ytimg.com/vi/17WoOqgXsRM/maxresdefault.jpg",
"privacyStatus": "public",
"unavailableReason": null,
"errorCode": null,
"message": null,
"input": "https://youtu.be/17WoOqgXsRM?list=PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH",
"source": "youtube-data-api-v3",
"fetchedAt": "2026-10-22T05:14:19.638Z"
}

A private video in another playlist (fields that are null are left out here):

{
"status": "unavailable",
"playlistId": "PL8F6B0753B2CCA128",
"position": 12,
"videoId": "zGsGwFBoEgc",
"url": "https://www.youtube.com/watch?v=zGsGwFBoEgc&list=PL8F6B0753B2CCA128",
"addedAt": "2019-05-07T04:31:35Z",
"privacyStatus": "private",
"unavailableReason": "private",
"message": "The video is private; YouTube hides its title and channel."
}

Output fields

The Videos view shows the main columns. The Status and errors view shows the status, error code and message of every row; sort or filter it by status to find rows that are not ok.

FieldTypeCan be nullExampleMeaning
statusstringnookRow status, see the table below.
playlistIdstringyesPLRqwX-V7Uu6…Playlist ID. null for a line that is not a playlist.
playlistTitlestringyesCoding ChallengesPlaylist name.
playlistChannelTitlestringyesThe Coding TrainWho owns the playlist.
playlistUrlstringyeshttps://www.youtube.com/playlist?list=…Playlist link.
positionintegeryes1Place in the playlist, from 1. null only for status rows.
videoIdstringyes17WoOqgXsRMVideo ID.
urlstringyeshttps://www.youtube.com/watch?v=…&list=…Opens the video inside the playlist.
titlestringyesCoding Challenge 1: Starfield SimulationVideo title. null for private and deleted videos.
descriptionstringyesVideo description.
channelTitle, channelIdstringyesThe Coding TrainWho uploaded the video. It can differ from the playlist owner.
publishedAtstring, ISO date UTCyes2016-04-13T03:17:50ZWhen the video was published.
addedAtstring, ISO date UTCyes2016-04-13T03:17:51ZWhen the video was added to the playlist.
durationSecintegeryes834Length in seconds. null for a live or upcoming stream, or when counts are off.
durationstringyesPT13M54SLength as YouTube gives it (ISO 8601).
views, likes, commentsintegeryes1389218Counts. null when the owner hides them, or when counts are off.
thumbnailUrlstringyeshttps://i.ytimg.com/vi/…/maxresdefault.jpgBiggest thumbnail.
privacyStatusstringyespublicpublic, unlisted, private or privacyStatusUnspecified.
unavailableReasonstringyesprivateprivate, deleted or unknown, for unavailable rows.
errorCode, messagestringyesPLAYLIST_NOT_FOUNDReason, for rows that are not ok.
inputstringyesYour original line, as you typed it.
sourcestringnoyoutube-data-api-v3Data source.
fetchedAtstring, ISO date UTCno2026-10-22T05:14:19.638ZWhen the run read the data.

Row statuses

statusWhenCharged
okA video at this positionplaylist-video event
unavailableThe video at this position is private or deletedsmall empty-result event
not_foundThe playlist does not exist, or it is privatesmall empty-result event
invalid_inputThe line is not a playlist (for example a channel link, WL or LL)small empty-result event
api_key_requiredNo key in the input (one row per run)no event
api_key_errorGoogle rejected the key, or the API is not enabled for it (one row per run)no event
quota_exceededYour daily quota ran out (one row)no event
errorGoogle kept failing for a playlist after retriesno event

Run summary

The run's key-value store has a RUN_SUMMARY record: run status (SUCCEEDED, PARTIAL, EMPTY, API_KEY_REQUIRED, API_KEY_ERROR, QUOTA_EXCEEDED, INVALID_INPUT, ERROR), stop reason (QUOTA_LIMIT, CHARGE_LIMIT, TIME_LIMIT, SOURCE_ERROR, ABORTED or none), row counts, quota units used, and one line per playlist with its outcome and size. The run's status message says the same in one line, for example Exported 10 videos from 1 playlist(s).

Pricing and cost examples

Pay per event. Apify platform usage is included. Google does not charge for the API quota.

EventWhenFreeBronzeSilverGold and above
Actor startonce per run, charged by Apify automatically$0.0008$0.0008$0.0008$0.0008
Playlist videoper ok row$0.0003$0.00027$0.00024$0.00021
Empty resultper unavailable, not_found or invalid_input row$0.00003$0.00003$0.00003$0.00003

That is $0.30 per 1,000 videos on the Free plan and $0.21 on Gold. Include duration and view/like/comment counts does not change the price.

Example runFreeBronzeSilverGold+
No key (one api_key_required row)$0.0008$0.0008$0.0008$0.0008
10 videos (the prefill)$0.0038$0.0035$0.0032$0.0029
100 videos$0.031$0.028$0.025$0.022
1,000 videos$0.30$0.27$0.24$0.21
20,000 videos$6.00$5.40$4.80$4.20
100 entries, all private or deleted$0.0038$0.0038$0.0038$0.0038

Every run pays the start fee, also a run without a key or with a wrong key. Apify charges it automatically when a paid Actor starts. Put many playlists in one run instead of many small runs.

Set Maximum cost per run in the run options to cap a run. The Actor checks the limit before it saves each page of rows. It stops before a charge would go above the limit, keeps what it saved and ends as PARTIAL with reason CHARGE_LIMIT.

Use cases

Buyer jobInputKey fieldsNext step
Course or tutorial outlinethe course playlistposition, title, durationSec, urlMake a syllabus or a watch plan with total hours
Audit a channel's playliststhe channel's playlist linksviews, likes, publishedAt, unavailableReasonFind weak, private or deleted videos
Archive or back up a playlistany public playlistvideoId, title, channelTitle, addedAtKeep a record of what was in it
Content researchcompetitor playliststitle, views, durationSec, publishedAtCompare topics, length and reach
Catalog for an app or modelmany playlistsall fieldsJoin on videoId or playlistId

API, export and AI agents

  • Export: download the dataset as JSON, CSV, Excel, XML or HTML.
  • API: start a run with POST https://api.apify.com/v2/acts/cliqtomedia~youtube-playlist-export/runs and the input JSON. Read rows from the run's default dataset.
  • Scheduling: use an Apify Schedule to export the same playlists every day or week and see new videos and new counts. The Actor does not keep data between runs.
  • Integrations: Make, Zapier, n8n, webhooks and Google Sheets work through the standard Apify integrations. Use playlistId + position or videoId as a key.

Use with AI agents (MCP)

  • MCP server with only this Actor: https://mcp.apify.com?tools=cliqtomedia/youtube-playlist-export
  • Smallest useful input: {"playlistUrls": ["PLRqwX-V7Uu6ZiZxtDDRCi6uhfTH4FilpH"], "maxItems": 10, "apiKey": "<the user's key>"}
  • Key output fields: position, title, videoId, durationSec, views, status.
  • 10 videos take a few seconds. In our tests 1,000 videos took about 10 seconds and 20,000 videos about 5 minutes.
  • The agent needs the user's own YouTube Data API key. Without it the run returns api_key_required.

Limits and partial results

  • Up to 100 playlists per run and up to 20,000 entries per playlist. We tested one run with 20,000 videos: done in about 300 seconds, 801 quota units, 79 MB of memory.
  • YouTube itself gives at most 20,000 entries for a channel's uploads (UU…) playlist, so very big channels are cut there.
  • The default run timeout is 600 seconds. For more than about 30,000 videos in one run, set a higher timeout in the run options. The Actor stops reading at 30 minutes or 20 seconds before the timeout, whichever comes first, keeps the saved rows and ends as PARTIAL with reason TIME_LIMIT.
  • If your daily quota runs out during a run, the Actor keeps the rows it saved, ends as PARTIAL with reason QUOTA_LIMIT, and the run SUCCEEDED. Run the rest after the quota resets.
  • If Google keeps failing for two playlists in a row, the run keeps saved rows and ends with reason SOURCE_ERROR.
  • Counts are live at fetchedAt and change all the time.

Data comes from the YouTube Data API v3 under your own key and Google project. Please follow the YouTube API Services Terms of Service: they say you should not keep statistics such as views and likes for more than 30 days without refreshing them. Refresh them with a new run, or delete old datasets. This Actor is not affiliated with or endorsed by YouTube or Google.

Troubleshooting

I got one api_key_required row

The YouTube Data API key field is empty. Get a key and run again.

I got one api_key_error row

Likely reasons: a typo in the key, the key was deleted, YouTube Data API v3 is not enabled in the key's project, or the key is limited to other APIs or websites. Check APIs & Services → Enabled APIs in Google Cloud Console. Enable the API, or make a new key.

The run ended with QUOTA_LIMIT

Your project used its 10,000 daily units. The rows saved before that are kept. Run again after midnight Pacific Time, or turn off Include duration and view/like/comment counts to use half the quota.

A playlist gives not_found

The playlist was deleted, is private, or the ID has a typo. Open playlistUrl in a browser while signed out. Only public and unlisted playlists can be read.

A line gives invalid_input

The line is not a playlist link or ID. For a channel link, the message gives the channel's uploads playlist ID (UU…): paste that instead. WL and LL are private to their owner. If no line in the run is a playlist, the run ends as FAILED with status INVALID_INPUT; the Actor start and the invalid_input rows are still charged as shown above.

Some rows are unavailable

The video at that position is private or deleted. YouTube hides its title and channel, so only the position, videoId and addedAt are known.

FAQ

Do I need a YouTube or Google account?

You need a Google account to make the free API key. The Actor does not log in to YouTube and does not use cookies.

Why are some positions not in a row 1, 2, 3?

They are. Every entry gets a row, also private and deleted ones, so position always matches the YouTube player. Filter by status = ok if you want only playable videos.

Can I export my Watch later or Liked videos?

No. Google serves these lists only to their owner after a sign-in (OAuth). An API key cannot read them. You can copy the videos into a normal public or unlisted playlist first.

Does it cost Google money?

No. The YouTube Data API is free within the daily quota. You pay only the Apify price above.

Is personal data included?

Only public playlist and video data that YouTube shows: playlist and channel names and IDs. No viewer data.

Support

For a bug, question or feature request, open an issue on the Actor's Issues tab. Add the run ID and your input, but never post your API key.