Google Takeout is the official way to pull a copy of your YouTube watch history out of your Google account. It works, and it's worth knowing how to use it. But it was built as a data-portability tool, not a history tool, and that shows up the moment you try to use the export for anything beyond a one-time archive.
How do you export your YouTube watch history with Google Takeout?
The process takes a few minutes. Here's the current path through Google's export tool:
- Go to takeout.google.com and sign in with the Google account tied to your YouTube history.
- Click Deselect all at the top, then scroll down and find YouTube and YouTube Music. Tick its checkbox.
- Click All YouTube data included to open the customisation panel. Untick everything except history to keep the export small and focused on watch history.
- In that same panel, find the format dropdown next to history and choose either HTML or JSON. JSON is the better choice if you plan to search or process the data with any tool; HTML is fine if you just want to open it in a browser and scroll.
- Click Next step, then choose how you want the archive delivered: a one-time email link, or saved directly to Drive, Dropbox, OneDrive, or Box.
- Choose your export frequency, file type (.zip or .tgz), and maximum archive size, then click Create export.
- Wait for Google's email. Small exports can arrive within minutes; larger ones can take hours.
- Download and unzip the archive. Your file is at
Takeout/YouTube and YouTube Music/history/watch-history.json(orwatch-history.html).
Google's export links are only valid for about 7 days and allow a limited number of downloads before they stop working. If you miss the window, you have to create a fresh export and wait again.
What does the export actually contain?
Each entry in watch-history.json is a single watch event with a handful of fields: a title field reading something like "Watched [video title]", a titleUrl pointing to the video, a subtitles block with the channel name and channel URL, and a time field giving an ISO 8601 timestamp of when the entry was logged. If you exported HTML instead, it's the same information laid out as a scrollable page of links and dates rather than structured data.
That's genuinely useful if what you want is a list of video titles and rough dates. It's a real record, and it's worth having as an occasional archive of your account.
What's missing from a Takeout export?
Two things the file does not contain, no matter which format you pick:
- Watch duration. There is no field for how long you actually watched, whether you watched the whole thing or closed it after ten seconds.
- Watch position. There is no timestamp for where you stopped inside the video. A 90-minute lecture you closed at the 40-minute mark looks identical in the export to one you finished start to finish.
That second gap is the one that matters most in practice. The export tells you a video was watched. It cannot tell you where to pick it back up. If your goal is genuinely finding your place again in something long, the file gives you a title and a date, then you're back to scrubbing the timeline by eye.
Is a Takeout export a real backup, or just a snapshot?
Google Takeout does support scheduling: instead of a single one-time export, you can set it to repeat automatically every 2 or 6 months for up to a year, with the first archive generated immediately. That's a genuine improvement over manually remembering to request one, and it's worth turning on if you want a periodic paper trail of your account data.
But even scheduled, it's still a snapshot taken every couple of months, not a live record. Anything you watch between exports doesn't exist anywhere until the next scheduled run catches up, and if you ever need to check what you watched three weeks ago on a specific afternoon, you're relying on whichever snapshot happens to cover that window. It also only covers YouTube itself. It says nothing about what you watched on the same Mac in Spotify, Apple Music, Apple Podcasts, SoundCloud, Twitch, or any other app or browser tab, so it's one file among many if you're trying to reconstruct a full picture of your media activity.
What does Echo do differently?
Echo records your YouTube activity on your Mac as you watch, with no export request, no waiting for an email, and no scheduling to configure. Every video you open, in Chrome, Safari, or another supported browser, gets logged the moment you play it, alongside everything else you play across native apps like Spotify, Apple Music, and Apple Podcasts. It all lives in one searchable, on-device history, with no account and nothing sent off your Mac.
The part a Takeout export can't give you at all: Echo captures the exact position you stopped at in a YouTube video, not just that you watched it. Press ⌘⇧E from anywhere on your Mac and Echo brings up your history, ready to resume any video right where you left off, down to the second.
Use Google Takeout when you want an official, portable copy of your account data for record-keeping. Use Echo when you actually want to find something you watched last week and pick it back up without hunting through a JSON file for a title that only tells you half the story.
Frequently asked
Does Google Takeout show how long I watched a YouTube video for?
Can Google Takeout give me a live or ongoing YouTube history?
Is Google Takeout's YouTube export HTML or JSON?
How long does a Google Takeout YouTube history export take?
Does Google Takeout cover what I watch outside of YouTube?
Your Watch History, Captured Live
Echo records every video you watch on your Mac the moment you watch it, with exact resume position, no export required.
One-time purchase, yours forever.