# The RarBg

> Torrent search site: movies, TV, anime, music, games, apps and books with
> IMDB metadata, IMDB/Rotten Tomatoes ratings and a 0-100 quality score per release.
> Read-only JSON API, Torznab feed, RSS and a Stremio addon. No API key needed (30 requests/minute and 10,000/day; a free key for signed-in accounts gives 60/minute and 50,000/day).

## JSON API
- `GET https://rarbg.unblockninja.st/api/v1/search/?q=...` - search with filters: category, imdb, season, episode, resolution (2160p,1080p,720p,480p), source (BluRay,WEB-DL,WEBRip,HDTV), codec (x265,x264,AV1), hdr=1, audio, language, year_min, year_max, rating_min, genre, min_seeders, size_min_gb, size_max_gb, no_cam=1, sort (seeders|date|size|quality|relevance), page, limit (1-50), clean=1 (drop duplicates and fakes)
- `GET https://rarbg.unblockninja.st/api/v1/title/{imdb}/` - one title and all its torrents, best quality first (season/episode optional)
- `GET https://rarbg.unblockninja.st/api/v1/title/{imdb}/extras/?country=US` - where to stream in a country, movie collection
- `GET https://rarbg.unblockninja.st/api/v1/suggest/?q=...` - title typeahead
- `GET https://rarbg.unblockninja.st/api/v1/calendar/?imdb=tt...,tt...` - next / latest episodes of TV shows
- `GET https://rarbg.unblockninja.st/api/v1/mirrors/` - official domains
- `GET https://rarbg.unblockninja.st/api/v1/status/` - health and index freshness (503 when down; page: https://rarbg.unblockninja.st/status/)
- `POST https://rarbg.unblockninja.st/api/v1/keys/` {"label": "..."} with an account token (Authorization: Bearer <JWT from POST /auth/api/v1/token/>) - free API key (60 req/min, 50,000/day, one per account); `GET https://rarbg.unblockninja.st/api/v1/keys/me/` with the key - usage
- `POST https://rarbg.unblockninja.st/api/v1/debrid/add/` and `/api/v1/debrid/cached/` - send to the caller's own Real-Debrid / AllDebrid / TorBox / Premiumize (key in X-Debrid-Key, never stored)
- Postman collection: https://rarbg.unblockninja.st/api/postman.js?v=1.05on
- OpenAPI spec: https://rarbg.unblockninja.st/api/openapi.js?v=1.05on  -  Swagger UI: https://rarbg.unblockninja.st/api/docs/  -  Guide: https://rarbg.unblockninja.st/developers/

Each torrent has: name, infoHash, magnet, category, size, seeders, leechers, added, imdb, qualityScore (0-100), resolution, source, codec, hdr, audio, releaseGroup, url.

## Sonarr / Radarr / Prowlarr
Generic Torznab indexer: `https://rarbg.unblockninja.st/api/torznab` (also `/api/torznab/api`; any API key). Supports t=search, t=tvsearch (imdbid, tmdbid, season, ep), t=movie (imdbid, tmdbid). Results are de-duplicated and every keyword must match. Put an account's API key in the indexer's API Key field for 60 req/min instead of 30.

## MCP and clients
- MCP server: https://rarbg.unblockninja.st/static/integrations/clients/mcp/README.md (npx trb-torrents-mcp, TRB_BASE_URL=https://rarbg.unblockninja.st)
- Python / JS clients and a Postman collection: https://rarbg.unblockninja.st/developers/#clients

## Stremio
Addon manifest: `https://rarbg.unblockninja.st/stremio/manifest.js?v=1.05on` (configure: https://rarbg.unblockninja.st/stremio/configure/)

## RSS
- Alerts: `https://rarbg.unblockninja.st/api/rss/search/?q=...&resolution=1080p` (saved search) and `https://rarbg.unblockninja.st/api/rss/title/{imdb}/?resolution=2160p&min_quality=70`
- `https://rarbg.unblockninja.st/latest/rss/` and per category: /latest/rss/movie/, /tv/, /anime/, /music/, /game/, /app/, /book/, /other/

## Pages
- `https://rarbg.unblockninja.st/imdb-detail/{imdb}/` (season/N/, season/N/episode/M/) - title page with torrents
- `https://rarbg.unblockninja.st/get-posts/keywords:<words>/` - search results; more keys: `category:`, `tag:`, `year_min:`, `year_max:`, `rating_min:`, `genre:`, `nocam:1`, `min_seeders:`, `order:quality|-se|-a|-s`
- `https://rarbg.unblockninja.st/upcoming/` - upcoming movies and TV with release dates and trailers
- `https://rarbg.unblockninja.st/collections/{tmdb_collection_id}/` - film series with torrents
- `https://rarbg.unblockninja.st/streaming/{netflix|prime|disney|apple|max|hulu|paramount|crunchyroll}/?country=US` - what's popular on a service, with torrents

## Use
- Pick the best release for a title: /api/v1/title/{imdb}/ and take the first torrent (sorted by qualityScore, then seeders)
- Only 4K HDR: /api/v1/search/?imdb=tt...&resolution=2160p&hdr=1
- Limits: 30 requests/minute and 10,000/day per IP (60/min and 50,000/day with an account's key); HTTP 429 + Retry-After when exceeded. Please cache responses.