https://github.com/superzombi/hdrezkaapi
HDRezka Python API
https://github.com/superzombi/hdrezkaapi
anime api cartoon films hdrezka movies python
Last synced: 6 months ago
JSON representation
HDRezka Python API
- Host: GitHub
- URL: https://github.com/superzombi/hdrezkaapi
- Owner: SuperZombi
- Created: 2021-12-22T16:55:37.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-02T17:58:03.000Z (8 months ago)
- Last Synced: 2025-03-28T16:07:47.153Z (7 months ago)
- Topics: anime, api, cartoon, films, hdrezka, movies, python
- Language: Python
- Homepage: https://pypi.org/project/HdRezkaApi/
- Size: 92.8 KB
- Stars: 92
- Watchers: 3
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# HdRezkaApi
## Install:
```
pip install HdRezkaApi
```
## Table of Contents:
1. [Usage](#usage)
2. [Film Information](#film-information)
3. [Translators priority](#translators-priority)
4. [getStream](#getstream)
5. [getSeasonStreams](#getseasonstreams)
6. [HdRezkaStream](#hdrezkastream)
7. [HdRezkaStreamSubtitles](#hdrezkastreamsubtitles)
8. [HdRezkaRating](#hdrezkarating)
9. [Proxy](#proxy)
10. [Cookies](#cookies)
11. [HdRezkaSearch](#hdrezkasearch)
12. [HdRezkaSession](#hdrezkasession)
## Usage
```python
from HdRezkaApi import HdRezkaApi
from HdRezkaApi.types import TVSeries, Movie
from HdRezkaApi.types import Film, Series, Cartoon, Anime
url = "https://hdrezka.ag/ __YOUR_URL__ .html"
rezka = HdRezkaApi(url)
if not rezka.ok:
print("Error:", str(rezka.exception))
raise rezka.exception
print(rezka.name)
print(rezka.thumbnail)
print( rezka.rating.value )
print( rezka.rating.votes )
print( rezka.translators )
print( rezka.otherParts )
print( rezka.seriesInfo )
print(rezka.type)
print(rezka.type == TVSeries == TVSeries() == "tv_series")
print(rezka.category)
print(rezka.category == Anime == Anime() == "anime")
print( rezka.getStream()('720p') ) # if movie
print( rezka.getStream('1', '1')('720p') )
print( dict(rezka.getSeasonStreams('1')) )
```
## Film Information
| Attribute | Description |
|----------------------------------|--------------------------------------|
| `self.id`| Film ID |
| `self.name`| Film name |
| `self.description`| Film description |
| `self.type`| [`HdRezkaFormat`](#hdrezkaformat)|
| `self.category`|[`HdRezkaCategory`](#hdrezkacategory)|
| `self.thumbnail` | Film thumbnail URL|
| `self.thumbnailHQ`| Film thumbnail in high quality |
| `self.rating` |[`HdRezkaRating`](#hdrezkarating) |
| `self.otherParts`|Other parts of this film `[{Film_name: url}]`|
| `self.translators`|[Translators dict by id](#translators)|
| `self.translators_names`|[Translators dict by names](#translators_names)|
| `self.seriesInfo`| [Series info](#seriesInfo) by translators|
| `self.episodesInfo`|All [seasons and episodes](#episodesInfo)|
#### `translators`
```
{
Translator_id: {
name: Translator_name,
premium: bool
}
}
```
#### `translators_names`
```
{
Translator_name: {
id: Translator_id,
premium: bool
}
}
```
#### `seriesInfo`
```
{
Translator_id: {
translator_name,
seasons: {1, 2},
episodes: {
1: {1, 2, 3},
2: {1, 2, 3}
}
}
}
```
#### `episodesInfo`
```
[
{
season: 1, season_text,
episodes: [
{
episode: 1, episode_text,
translations: [
{translator_id, translator_name, premium}
]
}
]
}
]
```
### HdRezkaFormat
Parent of classes: `TVSeries` and `Movie`
### HdRezkaCategory
Parent of classes: `Film`, `Series`, `Cartoon`, `Anime`
### Translators priority
```python
rezka = HdRezkaApi(url, translators_priority:list, translators_non_priority:list)
# or
rezka.translators_priority = new_value
rezka.translators_non_priority = new_value
```
#### `translators_priority`
Priority of translators IDs, where the further to the left, the more desirable the translation.
#### `translators_non_priority`
Priority of unwanted translator identifiers, where the further to the right, the less desirable the translation.
### sort_translators
```python
sort_translators(
translators=self.translators,
priority=self.translators_priority,
non_priority=self.translators_non_priority
)
```
### getStream
```python
getStream(season, episode, translation=None, priority=None, non_priority=None)
```
```python
getStream(
translation='Дубляж' or translation='56'
)
```
If type is movie then there is no need to specify season and episode.
```python
stream = rezka.getStream() # if movie
```
#### [`priority` and `non_priority`](#translators-priority)
### getSeasonStreams
```python
getSeasonStreams(season, translation=None, ignore=False, progress=None, priority=None, non_priority=None)
```
```python
getSeasonStreams(
translation='Дубляж' or translation='56'
)
```
#### [`priority` and `non_priority`](#translators-priority)
#### `ignore` - ignore errors
#### `progress` - callback function
```python
def progress(current, all):
percent = round(current * 100 / all)
print(f"{percent}%: {current}/{all}", end="\r")
print( dict(rezka.getSeasonStreams(1, ignore=True, progress=progress)) )
```
Output example:
```
{'1': , '2': , ...}
```
If an error occurs, an attempt will be made to repeat the request again.
But if the error occurs again, then `None` will be added to the final dict.
To ignore errors and retry requests until a response is received, specify the `ignore=True` option.
```python
for i, stream in rezka.getSeasonStreams('1'):
print(stream)
```
# HdRezkaStream
| Attribute | Description |
|------------------------|---------------------------------------------------------|
|`self.videos`|Dict of videos where the key is resolution and value is list of URLs|
|`self.name`| Film name |
|`self.translator_id` | Translator ID |
|`self.season` | Season number (`None` if film) |
|`self.episode`| Episode number (`None` if film) |
|`self.subtitles`| [HdRezkaStreamSubtitles](#hdrezkastreamsubtitles) object|
|`HdRezkaStream(resolution)`|Call object with argument to get the URL of the video|
### Usage examples:
```python
stream = rezka.getStream(1, 5)
print( stream('720p') )
print( stream('720') )
print( stream(1080) )
print( stream('Ultra') )
print( stream('1080p Ultra') )
print( stream.videos )
```
```
{
'360p': ['https://sambray.org/...mp4', 'https://stream.voidboost.cc/...mp4'],
'480p': ['https://sambray.org/...mp4', 'https://stream.voidboost.cc/...mp4'],
'720p': ['https://sambray.org/...mp4', 'https://stream.voidboost.cc/...mp4'],
}
```
# HdRezkaStreamSubtitles
| Attribute | Description |
|------------------------|-------------------------------|
|`self.subtitles`|Dict of subtitles where the key is the language code and value is the subtitle information|
| `self.keys`|List of available subtitle language codes|
| `self(id)` |Call object with argument to get URL of subtitles|
### Usage examples:
```python
stream = rezka.getStream(1, 5)
print( stream.subtitles.subtitles ) # { 'en': {'title': 'English', 'link': 'https:/'}, ... }
print( stream.subtitles.keys ) # ['en', 'ru']
print( stream.subtitles('en') ) # 'https:/'
print( stream.subtitles('English') ) # 'https:/'
print( stream.subtitles(0) ) # 'https:/'
# ^ index
```
# HdRezkaRating
| Attribute | Description |
|-----------------------------------|--------------------------------------------------|
| `self.value` | Rating value (`float`) |
| `self.votes` | Number of votes (`int`) |
# Proxy
```python
rezka = HdRezkaApi(url, proxy={'http': 'http://192.168.0.1:80'})
```
# Cookies
```python
rezka = HdRezkaApi(url, cookies={"dle_user_id": user_id, "dle_password": password_hash})
```
If you are not sure:
```python
rezka = HdRezkaApi(url, cookies=HdRezkaApi.make_cookies(user_id, password_hash))
```
Manually login:
```python
rezka = HdRezkaApi(url)
rezka.login("your_email@gmail.com", "your_password1234")
```
# HdRezkaSearch
`HdRezkaSearch(origin, proxy, headers, cookies)(query, find_all=False)`
### Fast search
```python
from HdRezkaApi.search import HdRezkaSearch
results = HdRezkaSearch("https://hdrezka.ag/")("film name")
```
```
[
{
'title': 'Film name',
'url': 'https://hdrezka.ag/__FILM_URL.html',
'rating': 7.8
}
]
```
### Advanced search
```python
from HdRezkaApi.search import HdRezkaSearch
results = HdRezkaSearch("https://hdrezka.ag/", cookies)("film name", find_all=True)
for page in results:
for result in page:
print(result)
```
```
{
'title': 'Film name',
'url': 'https://hdrezka.ag/__FILM_URL.html',
'image': 'https://hdrezka.ag/image.jpg',
'category': HdRezkaCategory()
}
```
#### HdRezkaCategory
`Series`, `Film`, `Cartoon`, `Anime`.
#### All pages
```python
print(results.all_pages)
```
```
[
[ {'title', 'url', 'image', 'category'}, ...],
[ {'title', 'url', 'image', 'category'}, ...],
...
]
```
#### Flatten results
```python
print(results.all)
```
```
[
{'title', 'url', 'image', 'category'},
{'title', 'url', 'image', 'category'},
...
]
```
#### Specific page
```python
print(results.get_page(2)) # page number
# or
print(results[1]) # index
```
[Searching with session](#searching-with-session)
# HdRezkaSession
HdRezkaSession allows you to log in once and not send login requests every time.
You can also specify origin to make requests to a same site. Origin in full urls will be ignored.
In the next example, the request will be made to the url: `"https://rezka_mirror.com/__YOUR_URL__.html"`
```python
from HdRezkaApi import HdRezkaSession
```
```python
with HdRezkaSession("https://rezka_mirror.com/") as session:
session.login("email@gmail.com", "password")
rezka = session.get("https://hdrezka.ag/__URL_PATH__.html")
```
Also when specifying origin you can specify only url path.
```python
with HdRezkaSession("https://rezka_mirror.com/") as session:
rezka = session.get("__URL_PATH__.html")
```
You can also not specify origin and then requests will be made to the URL you specified.
But then you won't be able to use login().
```python
with HdRezkaSession() as session:
rezka = session.get("https://hdrezka.ag/__URL_PATH__.html")
```
```python
with HdRezkaSession(cookies=cookies, headers=headers, proxy=proxy) as session:
# or inline seting up
session.cookies = cookies
session.headers = headers
session.proxy = proxy
```
#### [`translators_priority`](#translators-priority)
```python
with HdRezkaSession(translators_priority, translators_non_priority) as session:
# or inline seting up
session.translators_priority = new_value
session.translators_non_priority = new_value
```
### Searching with session
#### Fast search
```python
with HdRezkaSession("https://rezka_mirror.com/") as session:
results = session.search("film name")
```
#### Advanced search
```python
with HdRezkaSession("https://rezka_mirror.com/") as session:
session.login("email@gmail.com", "password")
results = session.search("film name", find_all=True)
for page in results:
for result in page:
print(result)
```
[More info](#hdrezkasearch)
## 💲Donate