A fast, public REST API for torrent-index search, movie & TV metadata, and game discovery. Built for developers who want simple endpoints and predictable JSON responses.
The Black Hole Bay API is a lightweight REST API that brings several types of media discovery into one interface. It normalizes data from multiple providers into simple, predictable JSON responses � so you don't need to integrate each provider separately.
Search across multiple torrent indexes simultaneously with merged, deduplicated results and ready-to-use magnet links.
Trending movies, now-playing listings, popular TV shows, and full details with cast, genres, and runtime from TMDB.
Recently released games from the last 6 months with Metacritic scores, genres, and platform data from RAWG.
Every search result is automatically indexed into a local database. If remote sources go down, the local index kicks in.
Automatic IP-based rate limiting at 120 requests per minute with 429 responses and exponential backoff guidance.
Illegal content auto-ban system, CSP headers, X-Frame-Options, and nosniff. No API keys exposed to clients.
Base URL: https://theblackholebay.lol
No signup. No API key. No authentication. Just send requests.
# Search torrents
curl "https://theblackholebay.lol/api/search?q=breaking+bad&category=200"
# Trending movies
curl "https://theblackholebay.lol/api/trending"
# Trending games
curl "https://theblackholebay.lol/api/trending_games"
# Movie details with cast
curl "https://theblackholebay.lol/api/movie/872585"Every endpoint returns JSON. See the full API reference for all endpoints, parameters, and response schemas.
+---------------------+
� Client / App �
� Web � Mobile � Bot �
+---------------------+
�
?
+---------------------+
� The Black Hole Bay �
� REST API �
+---------------------+
�
+-----------------+-----------------+
� � �
? ? ?
+------------+ +------------+ +------------+
� Torrent � � TMDB Data � � RAWG Data �
� Sources � � Movies/TV � � Games �
+------------+ +------------+ +------------+The API normalizes data from all providers into simple JSON responses. Clients consume one API instead of integrating TMDB, RAWG, and torrent sources directly.
| Provider | Used For | Key Required |
|---|---|---|
| TMDB | Movies and TV metadata | Yes (server-side) |
| RAWG | Game metadata | Yes (server-side) |
| Pirate Bay API | Torrent search data | No |
| 1337x | Torrent search (fallback) | No |
| Local Index | Cached torrents | No |
All provider API keys are kept server-side. They are never exposed in client-side responses.
Loading...