searchtube 2.0.0
A simple youtube search api for python without need of Youtube API key.
Requires Python: >=3.6

# SEARCHTUBE
A simple youtube search api for python without need of Youtube API key.

# Usage
```python
>>> pip install searchtube
```
```python
>>> from searchtube import Search
>>> Search('hello',count=20).results

>>>{'index': 1, 'title': 'Adele - Hello', 'video_id': 'YQHsXMglC9A', 'views': 2754625577, 'duration': '6:07', 'published': '5 years ago', 'thumbnail': 'https://i.ytimg.com/vi/YQHsXMglC9A/hq720.jpg?sqp=-oaymwEZCNAFEJQDSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLBD7CBVjwTujVCEPsyBSZGwFkIURA', 'gif_thumbnail': 'https://i.ytimg.com/an_webp/YQHsXMglC9A/mqdefault_6s.webp?du=3000&sqp=CIDX2P4F&rs=AOn4CLAGgBr16Zh3UgFqmrD91uxlWNko7g', 'description': "' Hello ' is taken from the new album, 25, out November 20. http://adele.com Available now from iTunes http://smarturl.it/itunes25\xa0...", 'channel_details': {'name': 'Adele', 'url': '/channel/UCsRM0YB_dabtEPGPTKo-gcw', 'thumbnail': 'https://yt3.ggpht.com/a-/AOh14GifFFczyWr1ZNN_zyXOFfvJ5tFDL6MZYNE0YQ=s68-c-k-c0x00ffffff-no-rj-mo'}, 'is_live': False}
```

# Advanced Usage
## Search suggestions

You can also print the suggestions that are made by youtube on your search. Here's how:
```python
>>> Search('hello',count=2).suggestions
```

## Estimated Results
prints total number of results available for a keyword
```python
>>> Search('hello',count=2).total_results
```

## Filters
Introducing filter feature. You can filter the youtube videos according to your choice !!
Guide to Filters:
** Note you can add many filters at once seperated by space. For ex: filter = "udlh tyvi feli"

```python
>>> Search('hello',count=30,filter='udlh tyvi feli').results
```

| Filter                         | filter name |
|--------------------------------|-------------|
| Upload Date : Last Hour        | udlh        |
| Upload Date : Today            | udtd        |
| Upload Date : This Week        | udtw        |
| Upload Date : This Month       | udtm        |
| Upload Date : This Year        | udty        |
| Type : Video                   | tyvi        |
| Type : Channel                 | tych        |
| Type : Playlist                | typl        |
| Type : Film                    | tyfi        |
| Type : Programme               | typr        |
| Duration : Short (< 4 Minutes) | dush        |
| Duration : Long (> 20 Minutes) | dulo        |
| Features : Live                | feli        |
| Features : 4K                  | fe4k        |
| Features : HD                  | fehd        |
| Features : Subtitles/CC        | fesu        |
| Features : Creative Commons    | fecc        |
| Features : 360                 | fe36        |
| Features : VR180               | fevr        |
| Features : 3D                  | fe3d        |
| Features : HDR                 | fehd        |
| Features : Location            | felo        |
| Features : Purchased           | fepu        |
| Sort By : Relevance            | sore        |
| Sort By : Upload date          | soup        |
| Sort By : View Count           | sovi        |
| Sort By : Rating               | sora        |

# Dealing with filter errors

## Error f01
Returned when the applied filter is not valid.
## Error f02
Returned when a filter caused a condition where it can't be filtered anymore or performing an invalid filter. For example : sorting Type by channel and then using duration short. Which is invalid.