node ytsr

УСТАРЕЛО

Этот репозиторий больше не поддерживается, рассмотрите возможность использования вместо него официального API.

узел-ytsr

Простой пакет js only для поиска видео на YouTube, плейлистов и многого другого. Не требует входа в систему или Google-API-ключа.

Поддерживать

Вы можете связаться с нами для поддержки на нашем чат-сервере

Использование

 const ytsr = require ( 'ytsr' ) ;

const searchResults = await ytsr ( 'github' ) ;

API

ytsr(searchString, [опции])

Ищет заданную строку

• searchString

  • строка поиска или URL-адрес (из getFilters) для поиска

• options

  • объект с опциями
  • возможные настройки:
  • gl[String] -> 2-значный код страны, по умолчанию US — позволяет локализовать запрос.
  • hl[String] -> 2-значный код языка, по умолчанию en — позволяет локализовать запрос.
  • SafeSearch[Boolean] -> извлекать элементы в режиме ограничения YouTube.
  • limit[integer] -> ограничивает извлекаемые элементы, по умолчанию — 100, установлено значение «Бесконечность», чтобы получить весь список результатов поиска — цифры <1 приводят к использованию значения по умолчанию.
  • Pages[Number] -> ограничивает извлекаемые страницы, страницы содержат 20-30 элементов, установлено значение «Бесконечность», чтобы получить весь список результатов поиска — числа <1 приводят к использованию лимита по умолчанию — перезаписывает лимит
  • requestOptions[Object] -> Дополнительные параметры для передачи в miniget, который используется для выполнения https-запросов.

• возвращает обещание

• Пример ответа

ytsr.getFilters(searchString, параметры)

Извлекает доступные фильтры для данной строки или ссылки.

Использование

 const ytsr = require ( 'ytsr' ) ;

const filters1 = await ytsr . getFilters ( 'github' ) ;
const filter1 = filters1 . get ( 'Type' ) . get ( 'Video' ) ;
const filters2 = await ytsr . getFilters ( filter1 . url ) ;
const filter2 = filters2 . get ( 'Features' ) . get ( 'Live' ) ;
const options = {
  pages : 2 ,
}
const searchResults = await ytsr ( filter2 . url , options ) ;

• searchString
  • строка для поиска
  • или ранее полученная ссылка на фильтр
• options
  • gl[String] -> 2-значный код страны, по умолчанию US — позволяет локализовать запрос.
  • hl[String] -> 2-значный код языка, по умолчанию en — позволяет локализовать запрос.
  • requestOptions[Object] -> Дополнительные параметры для передачи в miniget, который используется для выполнения https-запросов.
• возвращает обещание, результатом которого является Map<String, Map<String, Filter>>
• Пример ответа

ytsr.continueReq(данные продолжения)

Продолжает предыдущий запрос, извлекая еще одну страницу.
Предыдущий запрос нужно было выполнить с использованием ограничения количества pages .

Использование

 const ytsr = require ( 'ytsr' ) ;

const firstResultBatch = await ytsr ( 'github' , { pages : 1 } ) ;
const secondResultBatch = ytsr . continueReq ( firstResultBatch . continuation ) ;
const thirdResultBatch = ytsr . continueReq ( secondResultBatch . continuation ) ;

// You can now use the .items property of all result batches e.g.:
console . log ( firstResultBatch . items ) ;
console . log ( secondResultBatch . items ) ;
console . log ( thirdResultBatch . items ) ;

• возвращает обещание, разрешающееся в { continuation, items }

Связанное / Хорошо работает с

• узел-ytdl-core
• узел-ytpl

Установить

 npm install --save ytsr

Лицензия

Массачусетский технологический институт