yt-search

simple youtube search API and CLI

Easy to use

CLI usage

npm install -g yt-search

# enter interactive search and selection
yt-search superman theme

API usage

const ytSearch = require( 'yt-search' )

ytSearch( 'superman theme', function ( err, r ) {
  if ( err ) throw err

  const videos = r.videos
  const playlists = r.playlists
  const accounts = r.accounts

  const firstResult = videos[ 0 ]

  console.log( firstResult )
} )

Output

{
  title: 'Superman Theme',
  url: '/watch?v=e9vrfEoc8_g',
  videoId: 'e9vrfEoc8_g',
  seconds: 253,
  timestamp: '4:13',
  duration: {
    toString: [Function: toString],
    seconds: 253,
    timestamp: '4:13'
  },
  ago: '8 years ago',
  views: 29127516,

  author: {
    name: 'Movieclips Classic Trailers',
    id: 'oldhollywoodtrailers',
    url: '/user/oldhollywoodtrailers',

    userId: 'oldhollywoodtrailers',
    userName: 'Movieclips Classic Trailers',
    userUrl: '/user/oldhollywoodtrailers',

    channelId: '',
    channelName: ''
    channelUrl: ''
  }
}

About

Simple function to get youtube search results.

Why

Not sure..

How

Using HTTP requests and parsing the results with cheerio.

CLI interactive mode with node-fzf

Usage

const opts = {
  query: 'superman theme',
  pageStart: 1, // first youtube page result
  pageEnd: 3 // up until page 3
}

ytSearch( opts, function ( err, r ) {
  if ( typeof opts === 'string' ) {
    opts = {
      query: opts,
      pageStart: 1,
      pageEnd: 3
    }
  }

  // etc
} )

Installation

npm install yt-search # local module usage

npm install -g yt-search # global CLI usage

Test

npm test