CaptapiInstall

Summary

Search YouTube for a required query, with optional filters and cursor-based pagination. Results may come from the 24-hour cache when enabled.

Inputs

• Query (required) — Search terms or keywords; the UI description specifies at least 2 characters.
• Limit — Maximum number of items to return. Defaults to 20 when set to 0; maximum 200. The UI states a flat cost of 2 credits per call.
• Cursor — Pagination cursor from the previous response’s nextCursor. Leave empty for the first page.
• Type — Filter by result type: all, videos, shorts, channels, or playlists.
• SortBy — Sort by relevance, date, views, or rating. The UI lists popular as an alias for views.
• UploadDate — Filter by upload date: any, today, this_week, this_month, or this_year.
• Duration — Filter long-form videos by duration: any, under_4, 4_20, or over_20. Does not apply to Shorts.
• Region — ISO country code for localized results; the UI lists US as the default.
• Cache — Set true to use the 24-hour response cache; cache hits cost 0 credits and include cached and cachedAt in the response envelope. Defaults to false, which fetches fresh results.

Output shape

Not established by the provided source pack; the operation’s response shape is not specified in the visible source.

The UI describes nextCursor for requesting another page and notes that cache hits add cached and cachedAt to the response envelope. The source pack omits the execute implementation body, so the result item structure and envelope cannot be confirmed.

Links

• n8n community nodes installation guide