# YouTube Transcript to Notion: Save Transcripts and Notes

Source: https://transcript-yt.com/blog/youtube-transcript-to-notion · Updated 2026-11-21 · TranscriptYT

> Save a YouTube transcript to Notion with practical copy-and-paste steps, timestamped study notes, and an API workflow for importing videos automatically.

To save a YouTube transcript to Notion, copy the transcript into a page or use TranscriptYT’s free [YouTube video to notes tool](https://transcript-yt.com/youtube-video-to-notes) to generate structured notes first. For recurring imports, connect the [TranscriptYT API](https://transcript-yt.com/api) to the Notion API so your workflow fetches the text and writes it into your workspace. The useful choice is whether you need the complete wording, a shorter set of notes, or both.

## Choose between a full YouTube transcript and study notes

A transcript preserves the spoken wording. Notes organize that material into headings and key points. Keep the transcript when you need to check quotations, search for a specific phrase, or examine how a speaker builds an argument. Choose notes when you want a lecture outline, a tutorial checklist, or a quick review before a meeting.

For a reusable Notion page, put notes first and the transcript underneath. This makes the page readable without losing the source material. Add your own observations in a separate section so you can distinguish the speaker’s words, generated notes, and your interpretation.

Decide on this structure before importing a collection of videos. Consistent pages are easier to review than a mixture of raw caption dumps, unexplained summaries, and bookmarks.

- Research: save the full transcript, source URL, and timestamps for passages you may cite.
- Study: save section notes, questions to revisit, and the original video link.
- Tutorials: save the steps, then add your own results and corrections as you follow along.

## How to copy a YouTube transcript into Notion

For an occasional video, copying the text is the shortest workflow. Open the [YouTube transcript tool](https://transcript-yt.com/youtube-transcript), paste the video URL, and retrieve the transcript. Check that the selected language and the beginning of the text match the video before saving it.

Create a Notion page with the video’s title. Put the source link near the top, then add a Transcript heading and paste the text below it. Preserve timestamps if you expect to revisit exact moments; omit them when uninterrupted reading matters more.

If a long paste becomes awkward to format, save the text as a .txt or .md file and use Notion’s import option. Notion supports both formats as page imports, according to its [import documentation](https://www.notion.com/help/import-data-into-notion). Check the resulting headings and paragraph breaks after importing.

- Copy the video URL and retrieve its transcript.
- Name the Notion page after the video and add the source URL.
- Paste the transcript under its own heading.
- Compare a passage with the video, especially names, numbers, and technical terms.
- Add a short note explaining why you saved the video.

## Turn YouTube videos into Notion notes with timestamps

The video-to-notes tool generates section headings, bullet points, and timestamps from a video’s transcript. Copy the notes as Markdown, then paste them into your Notion page. If the pasted Markdown remains literal text, save it as a .md file and import it through Notion’s Text & Markdown importer.

The tool offers some free daily usage without an account, and signing in raises the limit. Treat this browser workflow separately from the API’s credit allowance. It is useful for reviewing a video before deciding whether it belongs in your permanent library.

Keep the source URL beside the notes. The copied Markdown includes timestamp labels, so check whether your saved version has working video links before relying on it for navigation. You can add links to important moments yourself.

Read the generated notes once before marking the page complete. For a tutorial, check that prerequisites and warnings survived the summary. For a lecture, check definitions and qualifications. Add unanswered questions below the notes rather than treating an abbreviated explanation as the full argument.

## Organize YouTube transcripts in a Notion video library

Once you save videos regularly, use a consistent library structure. A useful starting point is one page per video, with the same source details at the top and the same content headings below. You can build that structure by hand before automating it.

Use the YouTube video ID as a stable identifier in your workflow. Different URLs can point to the same video, so comparing the complete pasted URL can miss duplicates. If you keep several language versions, include the language in your duplicate check.

Separate imported material from personal notes. A future refresh should replace the generated content without overwriting annotations you added while watching. The same principle applies to a [searchable transcript library](https://transcript-yt.com/blog/build-searchable-video-library-transcripts): preserve the source and keep the useful context attached.

- Source details: title, video URL, video ID, language, and import date.
- Review status: queued, imported, reviewed, or needs attention.
- Generated content: overview, timestamped notes, and full transcript.
- Personal work: observations, action items, questions, and checked quotations.

## Automatically send a YouTube transcript to Notion with the API

A basic automation retrieves a transcript, converts its text into Notion blocks, and appends those blocks to a destination page. TranscriptYT accepts a YouTube URL or video ID at GET /v1/transcript, authenticated with an Authorization: Bearer header. The JSON response includes text, segments, videoId, title, and language. See the [API documentation](https://transcript-yt.com/docs) for the complete response.

The Python example below appends a transcript to an existing Notion page. Install requests, then set TRANSCRIPTYT_API_KEY, NOTION_TOKEN, NOTION_PAGE_ID, and YOUTUBE_URL in your environment. Use a Notion token authorized to write to that page; Notion’s [API quickstart](https://developers.notion.com/guides/notion-api/quick-start) explains token setup.

Notion limits each rich-text content value to 2,000 characters and each append request to 100 child blocks. This example uses smaller chunks and batches to stay below those limits. The relevant references are [request limits](https://developers.notion.com/reference/request-limits) and [append block children](https://developers.notion.com/reference/patch-block-children).

Run it on a test page first. It appends content each time and does not detect previous imports. The character-based splitting is deliberately simple; a finished workflow should prefer paragraph boundaries and preserve timestamped segments when navigation matters.

```
import os
import time
import requests

video_url = os.environ['YOUTUBE_URL']
response = requests.get(
    'https://transcript-yt.com/v1/transcript',
    params={'url': video_url, 'mode': 'captions'},
    headers={
        'Authorization': 'Bearer ' + os.environ['TRANSCRIPTYT_API_KEY']
    },
    timeout=120,
)
response.raise_for_status()
data = response.json()

text = (
    data['title'] + '\n'
    + 'https://www.youtube.com/watch?v=' + data['videoId']
    + '\n\n' + data['text']
)
blocks = [
    {
        'object': 'block',
        'type': 'paragraph',
        'paragraph': {
            'rich_text': [
                {'type': 'text', 'text': {'content': text[i:i + 1000]}}
            ]
        },
    }
    for i in range(0, len(text), 1000)
]

page_id = os.environ['NOTION_PAGE_ID']
headers = {
    'Authorization': 'Bearer ' + os.environ['NOTION_TOKEN'],
    'Notion-Version': '2026-03-11',
    'Content-Type': 'application/json',
}
for offset in range(0, len(blocks), 20):
    for attempt in range(5):
        saved = requests.patch(
            f'https://api.notion.com/v1/blocks/{page_id}/children',
            headers=headers,
            json={'children': blocks[offset:offset + 20]},
            timeout=60,
        )
        if saved.status_code != 429:
            break
        time.sleep(float(saved.headers.get('Retry-After', '1')))
    saved.raise_for_status()

print('Transcript appended to Notion.')
```

## Add automatic notes and budget for API credits

To import generated notes, call GET /v1/summary with the video URL and the same bearer authentication. Its response contains summary, keyPoints, and notes. Each notes item includes start, heading, and bullets. Map these into an overview paragraph, section headings, and bullet blocks in Notion.

Keep this as a separate mapping step. Changing the transcript endpoint to the summary endpoint is insufficient because the response fields differ. If you want both full wording and notes, request both and account for both calls.

The Free API plan includes 100 one-time credits, not a monthly refill, and reads existing captions. Micro costs $3 per month for 1,000 credits. A standard caption transcript request costs 1 credit. Summary requests usually cost 2 credits, with higher costs for longer material; read X-Credits-Charged for the actual charge.

The example explicitly selects captions mode. AI transcription through the API requires a paid plan or credit pack. Newly generated AI transcripts cost 1 credit per started audio minute; subsequent cache hits cost 1 credit. Avoid estimating transcription costs solely from the number of saved videos.

## Prevent duplicate pages and incomplete transcript imports

Before scheduling imports, add a record that connects each video ID and language to its destination page. Check that record before fetching again. Save the fetched response so a failed Notion write can resume without unnecessarily repeating transcript retrieval.

Track completion separately from page creation. A page can exist even when only part of a long transcript was written. Store the last confirmed batch and verify the final text before marking the import complete.

After an uncertain write timeout, inspect the destination before retrying: the request may have succeeded even though your script did not receive the response. This prevents repeated paragraphs.

- Missing captions: record the failure and decide whether paid AI transcription is appropriate.
- Notion access error: verify the page ID and the token’s access to that page.
- HTTP 429: respect Retry-After rather than retrying immediately.
- Unexpected wording: compare the transcript or generated note with the original video.
- Refreshes: preserve personal annotations while replacing imported content.

## FAQ

### How do I put a YouTube transcript into Notion?

Retrieve the transcript, create a Notion page, and paste the text beneath the video’s source link. For repeated imports, fetch the transcript through TranscriptYT’s API and write it to Notion through its API.

### Can I save YouTube notes to Notion for free?

TranscriptYT’s browser note-taking tool offers limited free daily usage, and you can copy the generated Markdown into Notion. The API has a separate Free plan with 100 one-time credits.

### Can I automatically save YouTube transcripts to Notion?

Yes. A script can retrieve a transcript and append it to a Notion page. Add duplicate detection and progress tracking before scheduling recurring imports.

### Will my Notion notes keep YouTube timestamps?

They can if you preserve them during copying or API mapping. TranscriptYT’s notes include timestamps, and its transcript JSON includes segment timings; check that any links you create open the intended moment.
