ACTION_ID: enrich_youtube_video
NAME: Enrich YouTube Video with Transcript
CATEGORY: Web Research
CREDITS: 1

Pull a YouTube video's metadata — title, description, publish date,
views, likes and channel stats — with the transcript optionally included
in the same call.

1. INPUTS

youtube_video_or_share_url (type: url, required)
  Youtube Video or Share URL. Complete YouTube video URL or share URL
  for enrichment

country (type: string, optional)
  Country. Country of search. Default is United States.

language_of_search (type: string, optional)
  Language of Search. Language of search. Default is English.

include_transcript (type: boolean, optional)
  Include Transcript. Enable this to include the transcript for the
  video.

2. OUTPUTS

video_title (string) — Title of the YouTube video

description (string) — Description of the YouTube video

published_date (string) — Published date of the YouTube video

views (number) — Number of views

likes (number) — Number of likes

channel_name (string) — Channel name

channel_link (string) — Channel link

channel_subscribers (number) — Number of channel subscribers

transcript (string) — Transcript of the YouTube video

3. HOW TO CONFIGURE

Configure Action body:

{
  "inputs": {
    "youtube_video_or_share_url": "{{input.video_url}}",
    "include_transcript": true
  }
}

Field-by-field:
  - youtube_video_or_share_url  Required. A full watch URL or a
                                `youtu.be` share URL.
  - include_transcript          Boolean. `true` adds the transcript to
                                the same call.
  - country / language          Default to United States / English.
                                Neither has a dynamic-options resolver.

4. KEY NOTES

- With `include_transcript` true this action covers both metadata and
  transcript for one credit — cheaper than pairing it with
  `youtube_extract_video_transcript`, which costs a credit of its own.
- The transcript comes back as a single concatenated string. Use
  `youtube_extract_video_transcript` when you need timestamped segments.
- `include_transcript` is a radio field — pass a real boolean, not
  `"true"`.
- Videos with transcripts disabled return metadata with an empty
  `transcript` rather than failing the row.

5. WHERE IT FITS IN A WORKFLOW

Pattern: web_search_using_serp_api (youtube_search) ->
push_data_to_sheet -> enrich_youtube_video -> llm_models (summarise the
pitch).

6. WHEN TO USE

Use enrich_youtube_video when you want a video's stats and its words
together — competitor webinars, founder interviews, product launches.

7. WHEN NOT TO USE

Only need the transcript, with timestamps or language control
  -> action-detail/youtube_extract_video_transcript.txt

Need to find the videos in the first place
  -> action-detail/web_search_using_serp_api.txt

Last updated: 2026-08-03.