HdRezkaApi 11.1.0

HDRezka Python API

HdRezkaApi

Install:

pip install HdRezkaApi

Table of Contents:

1. Usage
2. Film Information
3. Translators priority
4. getStream
5. getSeasonStreams
6. HdRezkaStream
7. HdRezkaStreamSubtitles
8. HdRezkaRating
9. Proxy
10. Cookies
11. HdRezkaSearch
12. HdRezkaSession

---

Usage

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
self.category	HdRezkaCategory
self.thumbnail	Film thumbnail URL
self.thumbnailHQ	Film thumbnail in high quality
self.rating	HdRezkaRating
self.otherParts	Other parts of this film [{Film_name: url}]
self.translators	Translators dict by id
self.translators_names	Translators dict by names
self.seriesInfo	Series info by translators
self.episodesInfo	All seasons and episodes

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

from HdRezkaApi.types import TVSeries, Movie
rezka.type == TVSeries == TVSeries() == "tv_series"

HdRezkaCategory

Parent of classes: Film, Series, Cartoon, Anime

from HdRezkaApi.types import Film, Series, Cartoon, Anime
rezka.category == Anime == Anime() == "anime"

---

Translators priority

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

sort_translators(
	translators=self.translators,
	priority=self.translators_priority,
	non_priority=self.translators_non_priority
)

---

getStream

getStream(season, episode, translation=None, priority=None, non_priority=None)

getStream(
	translation='Дубляж' or translation='56'
)

If type is movie then there is no need to specify season and episode.

stream = rezka.getStream() # if movie

priority and non_priority

---

getSeasonStreams

getSeasonStreams(season, translation=None, ignore=False, progress=None, priority=None, non_priority=None)

getSeasonStreams(
	translation='Дубляж' or translation='56'
)

priority and non_priority

ignore - ignore errors

progress - callback function

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': <HdRezkaStream(season:1, episode:1)>, '2': <HdRezkaStream(season:1, episode: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.

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 object
HdRezkaStream(resolution)	Call object with argument to get the URL of the video

Usage examples:

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:

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

rezka = HdRezkaApi(url, proxy={'http': 'http://192.168.0.1:80'})

Cookies

rezka = HdRezkaApi(url, cookies={"dle_user_id": user_id, "dle_password": password_hash})

If you are not sure:

rezka = HdRezkaApi(url, cookies=HdRezkaApi.make_cookies(user_id, password_hash))

Manually login:

rezka = HdRezkaApi(url)
rezka.login("[e-mail]", "your_password1234")

---

HdRezkaSearch

HdRezkaSearch(origin, proxy, headers, cookies)(query, find_all=False)

Fast search

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

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

print(results.all_pages)

[
	[ {'title', 'url', 'image', 'category'}, ...],
	[ {'title', 'url', 'image', 'category'}, ...],
	...
]

Flatten results

print(results.all)

[
	{'title', 'url', 'image', 'category'},
	{'title', 'url', 'image', 'category'},
	...
]

Specific page

print(results.get_page(2)) # page number
# or
print(results[1]) # index

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"

from HdRezkaApi import HdRezkaSession

with HdRezkaSession("https://rezka_mirror.com/") as session:
	session.login("[e-mail]", "password")
	rezka = session.get("https://hdrezka.ag/__URL_PATH__.html")

Also when specifying origin you can specify only url path.

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().

with HdRezkaSession() as session:
	rezka = session.get("https://hdrezka.ag/__URL_PATH__.html")

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

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

with HdRezkaSession("https://rezka_mirror.com/") as session:
	results = session.search("film name")

Advanced search

with HdRezkaSession("https://rezka_mirror.com/") as session:
	session.login("[e-mail]", "password")
	results = session.search("film name", find_all=True)
	for page in results:
		for result in page:
			print(result)

More info

---

💲Donate

	Donatello
	Donation Alerts