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

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

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

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

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("your_email@gmail.com", "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("email@gmail.com", "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("email@gmail.com", "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