Block: YouTube Block — Zelaxy Docs

The YouTube block finds relevant videos using the YouTube Data API. Reach for it when your workflow needs to discover content, surface video metadata, or feed search results into downstream steps with a customizable result limit.

Overview

Property	Value
Type	`youtube`
Category	tools
Color	`#FF0000`

When to Use

Search YouTube for videos matching a user- or workflow-supplied query.
Pull structured video metadata to enrich a record, message, or report.
Gather a capped list of candidate videos for an agent to summarize or rank.
Power a content-discovery step that responds to incoming triggers.
Build research or monitoring flows that track topics across YouTube.

Configuration

Search Query

The text to search for. Required.

YouTube API Key

Your YouTube Data API key used to authenticate the request. Required and stored as a secret.

Max Results

A slider (0–20) that caps how many video results are returned.

Inputs & Outputs

Inputs:
- query (string) — the query for the YouTube search
- apiKey (string) — the API key for the YouTube search
- maxResults (number) — the maximum number of results to return
Outputs:
- items (json) — the items returned by the YouTube search
- totalResults (number) — the total number of results returned by the YouTube search

Tools

YouTube Search (youtube_search) — Calls the YouTube Data API v3 search endpoint to find videos matching a query. Accepts query (required), apiKey (required), and maxResults (optional, default 5). Returns an array of video objects — each containing videoId, title, description, and thumbnail — plus a totalResults count and an optional nextPageToken for pagination.

YAML Example

youtube_1:
  type: youtube
  name: "YouTube"
  inputs:
    query: {{start.input}}
    apiKey: "{{YOUTUBE_API_KEY}}"
    maxResults: 5
  connections:
    outgoing:
      - target: next-block-id

YouTube Block