GUIDES

Practical YTSearch CLI workflows.

Use these focused workflows to search YouTube, automate JSON output, work interactively, and retrieve playlist pages from the terminal.

Search by content type

Choose video, channel, playlist, movie, or live when you know the kind of YouTube result you want.

Read guide →
Build a JSON pipeline

Combine --json with scripts and other terminal tools when formatted tables are not appropriate.

Read guide →
Use interactive mode

Launch --watch when you prefer a guided menu for searches, details, settings, and playlist actions.

Read guide →
Walk large playlists

Use playlist-videos and pagination to work through playlist pages instead of treating a playlist as one flat result.

Read guide →

Example workflow

$ytsearch video "node.js tutorial" --limit 20 --sort view_count --mode detailed

For programmatic access to the underlying data layer, continue to ytsearch.js.