npm package: @neeraj-x0/ytsearch
Description: Simple package to search YouTube - no strings attached.
Author: Neeraj-x0
Latest version: 1.0.0

# node-ytsearch

Simple js only package to search for Youtube for Videos, Playlists and many more.
Does not require any login or Google-API-Key.

# Support
You can contact us for support on our [chat server](https://discord.gg/V3vSCs7)

# Usage

```js
const ytsearch = require('@neeraj-x0/ytsearch');

const searchResults = await ytsearch('github');
```


# API
### ytsearch(searchString, [options])

Searches for the given string

* `searchString`
    * search string or url (from getFilters) to search from
* `options`
    * object with options
    * possible settings:
    * gl[String] -> 2-Digit Code of a Country, defaults to `US` - Allows for localisation of the request
    * hl[String] -> 2-Digit Code for a Language, defaults to `en` - Allows for localisation of the request
    * safeSearch[Boolean] -> pull items in youtube restriction mode.
    * limit[integer] -> limits the pulled items, defaults to 100, set to Infinity to get the whole list of search results - numbers <1 result in the default being used
    * pages[Number] -> limits the pulled pages, pages contain 20-30 items, set to Infinity to get the whole list of search results - numbers <1 result in the default limit being used - overwrites limit
    * requestOptions[Object] -> Additional parameters to passed to [miniget](https://github.com/fent/node-miniget), which is used to do the https requests

* returns a Promise

### ytsearch.getFilters(searchString, options)

Pulls avaible filters for the given string or link

#### Usage

```js
const ytsearch = require('@neeraj-x0/ytsearch');

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

* `searchString`
    * string to search for
    * or previously optained filter ref
* `options`
    * gl[String] -> 2-Digit Code of a Country, defaults to `US` - Allows for localisation of the request
    * hl[String] -> 2-Digit Code for a Language, defaults to `en` - Allows for localisation of the request
    * requestOptions[Object] -> Additional parameters to passed to [miniget](https://github.com/fent/node-miniget), which is used to do the https requests
* returns a Promise resulting in a `Map<String, Map<String, Filter>>`

### ytsearch.continueReq(continuationData)
Continues a previous request by pulling yet another page.  
The previous request had to be done using `pages` limitation.

#### Usage
```js
const ytsearch = require('@neeraj-x0/ytsearch');

const firstResultBatch = await ytsearch('github', { pages: 1 });
const secondResultBatch = ytsearch.continueReq(firstResultBatch.continuation);
const thirdResultBatch = ytsearch.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);
```

* returns a Promise resolving into `{ continuation, items }`



# Install

    npm install --save @neeraj-x0/ytsearch

# License
MIT