Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@stophy/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

stophy

CLI for the Stophy YouTube data API. Search videos, get transcripts, read comments, browse channels, and fetch playlists. All output is JSON.

Install

npm install -g stophy-cli

Requires Node.js 18 or later. Get an API key from stophy.dev/dashboard.

Auth

stophy login --browser           # opens OAuth in browser (recommended)
stophy login --api-key st_xxx    # paste API key directly
export STOPHY_API_KEY="st_..."   # or set env var

Commands

search

stophy search --q "typescript tutorial" --type video --sortBy viewCount
stophy search --q "next.js" --uploadDate week --duration long

video details

stophy video details --url "https://youtube.com/watch?v=QRvfjPltvmE"

{
  "id": "QRvfjPltvmE",
  "title": "TraRags Reacts To Kendrick Lamar - GNX",
  "author": "TRA RAGS STREAMS",
  "viewCount": 204828,
  "likeCount": 9170,
  "durationText": "2 hours 42 minutes 27 seconds",
  "publishedAt": "2024-11-23T08:22:36.000Z"
}

video transcript

stophy video transcript --url "https://youtube.com/watch?v=..."

{
  "language": "en",
  "segments": [
    { "text": "what is up everybody", "start": 0.0, "duration": 1.96 },
    { "text": "welcome back to the channel", "start": 1.96, "duration": 2.0 }
  ]
}

video comments

stophy video comments --url "https://youtube.com/watch?v=QRvfjPltvmE" --sortBy top

{
  "items": [
    { "text": "\"Nah, that's not enough\" 😂", "author": "@terribletimes902", "likeCount": 2100 },
    { "text": "53:15 BRO CREAMED HIMSELF LIVE 😭😭😭😭", "author": "@Aunos1", "likeCount": 593 },
    { "text": "WHO ELSE BACK TO THIS AFTER THE ICEMAN REACTION?? 🙌🏾✊🏾", "author": "@colouredhearts", "likeCount": 134 }
  ],
  "continuationToken": "..."
}

channel

stophy channel --url "https://youtube.com/@t3dotgg" --tab video --sortBy popular

{
  "channel": {
    "name": "Theo - t3.gg",
    "handle": "@t3dotgg",
    "subscriberCount": "539K subscribers",
    "videoCount": "1K videos",
    "isVerified": true
  },
  "items": [
    { "title": "PirateSoftware is right, this needs to stop", "viewCount": 1000000, "duration": "15:14" }
  ]
}

playlist

stophy playlist --url "https://youtube.com/playlist?list=PLxxxx"

usage and logs

stophy usage --days 7
stophy logs --days 30 --endpoint /v1/video

All commands

Command	Description
`stophy login`	Log in to your Stophy account
`stophy search`	Search YouTube videos, channels, and playlists
`stophy suggest`	Get YouTube search autocomplete suggestions
`stophy video details`	Get video metadata
`stophy video transcript`	Get timestamped transcript
`stophy video comments`	Get paginated comments
`stophy video replies`	Get comment replies
`stophy channel`	Browse a channel's videos, shorts, playlists, or about page
`stophy playlist`	Get all videos in a playlist with full metadata
`stophy credits`	Show your remaining credit balance
`stophy usage`	Show API usage for your key
`stophy logs`	Show request logs for your key
`stophy view-config`	Show your current config and auth status
`stophy logout`	Clear saved credentials

Each command supports --help for full options. See docs.stophy.dev for response shapes.

License

MIT