Social FetchInstall

Summary

Searches YouTube content for the required query and returns the first page or paginates through all available results. Optional filters control upload date, sort order, content type, duration, and region; enabling Include Extras requests richer per-video metadata when available.

Inputs

• Query (required) — Search text for YouTube content.
• Return All — When enabled, follows the result cursor and accumulates pages until no more results are available. Each page consumes API credits; when disabled, returns only the first page.
• Upload Date — Optional upload date filter: today, this week, this month, or this year.
• Sort By — Optional sort order: relevance or popular.
• Type — Optional content type: videos, shorts, channels, or playlists.
• Duration — Optional duration filter for videos: under 3 minutes, 3–20 minutes, or over 20 minutes. The property description says this does not apply to shorts.
• Region — Optional ISO 3166-1 country code for localized results.
• Include Extras — When enabled, requests richer per-video metadata when available; this may increase response time.
• Batching — Request batching settings for throttling: items per batch (-1 disables batching; 0 is treated as 1) and interval in milliseconds (0 disables the interval).
• Ignore SSL Issues (Insecure) — Whether to accept responses when SSL certificate validation is not possible.
• Proxy — Optional HTTP proxy URL; credentials can be included in the URL if required.
• Timeout — Time in milliseconds to wait for response headers before aborting the request.

Output shape

A list of YouTube search result items, with one item per result across the requested page or pages.

With Return All disabled, only the first page is returned. With it enabled, cursor pagination accumulates pages until hasMore is false. Include Extras may add per-video metadata when available; the exact item fields are not shown in the supplied source pack.

Examples

Example 1: Find recent tutorial videos

Query: "automation"; Type: Videos; Upload Date: This Month; Sort By: Relevance; Return All: off.

Example 2: Collect all matching channels for a region

Query: "renewable energy"; Type: Channels; Region: US; Return All: on.

Links

• n8n community nodes installation guide