Agora PreDB API

Access one of the largest French release databases through a modern REST API.

21 174 427

Releases

61 728

Teams

16 742

NUKED

Endpoints

Sources

🔑 Get API Key ⚡ API Playground 📖 Quick Start

●API Status: Operational

Version: v1 Base URL: https://watch.nhccloud.ca/api/v1/ Rate Limit: 5,000/day

⚡ Quick Start

cURL

curl -H "X-API-Key: YOUR_KEY" "https://watch.nhccloud.ca/api/v1/latest?limit=10"

Python

import requests
r = requests.get("https://watch.nhccloud.ca/api/v1/latest",
    headers={"X-API-Key": "YOUR_KEY"}, params={"limit": 10})
releases = r.json()
for rel in releases:
    print(rel["name"], rel["resolution"], rel["team_name"])

JavaScript (Node.js / Fetch)

const res = await fetch("https://watch.nhccloud.ca/api/v1/latest?limit=10", {
    headers: { "X-API-Key": "YOUR_KEY" }
});
const releases = await res.json();
releases.forEach(r => console.log(r.name, r.categ));

PHP

$ch = curl_init("https://watch.nhccloud.ca/api/v1/latest?limit=10");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: YOUR_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$releases = json_decode(curl_exec($ch), true);
foreach ($releases as $r) echo $r['name'] . "\n";

⚡ API Playground

Click "Execute" to test an endpoint...

📖 Endpoints Reference

Releases

GET/releasespaginatedfilterable

List releases with full filtering: q, team, source, cat, size_min, size_max, sort, order, format (rss).

Params: q, page, limit, sort, order, source, team, cat, size_min, size_max, format

GET/releases/count

Exact total count for the same filters as /releases.

Same params as /releases (without page/limit)

GET/release/{id}

Full release detail including related releases, source timeline, NUKE history.

Returns: release object + related[] array

GET/latestfast

Latest releases (most recent first). Optional: ?cat=Films&limit=20

Params: limit (max 200), cat

GET/trending

Trending releases by dynamic score (views + favorites + seeders + recency).

Params: limit (max 100)

Search

GET/search/suggestmeilisearch<20ms

Fuzzy search with typo tolerance. Returns highlighted suggestions. Powered by Meilisearch.

Params: q (required), limit (max 10). Supports typos: "interstllar" → Interstellar

Teams

GET/teamspaginated

List teams with aggregated stats (releases count, total size).

Params: q, page, limit, min_releases, source

GET/teams/{name}

Team detail: stats + 10 recent releases + first/last activity dates.

GET/teams/{name}/stats

Detailed breakdown: categories distribution, size stats, tech stats (resolution, codec, language, HDR).

GET/teams/{name}/releasespaginated

All releases for a team (paginated).

Params: page, limit

Titles

GET/title/{tmdb_id}paginated

All releases for a TMDB title. Includes total count and pagination.

Params: page, limit

NFO

GET/releases/nfo

NFO content as plain text.

Params: name (required), source

GET/releases/nfo/download

Download .nfo as file attachment.

Params: name (required), source. Rate limited: 20/min

Statistics

GET/stats

Global site statistics: totals, top categories, top teams, volume.

GET/categories

Flat list of all release categories with counts.

⚠️ Rate Limits

Plan	Limit	Notes
Anonymous	100 / day	No API key required
Registered	5,000 / day	Free account + API key
Premium	25,000 / day	Contact us

Response headers when rate limited (HTTP 429):

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4753
X-RateLimit-Reset: 2026-06-25T00:00:00Z

📦 Data Objects

Release Object

{
  "id": 3382,
  "name": "Interstellar.2014.MULTi.1080p.WEB.H265-CHiLL",
  "source": "P2P",
  "size": "3818079597",
  "date": "2026-06-24T05:55:52",
  "categ": "Movies",
  "team_name": "CHiLL",
  "resolution": "1080p",
  "video_codec": "h265",
  "language": "MULTI",
  "hdr": null,
  "has_nfo": true,
  "media_id": "movie:157336",
  "release_type": null,
  "year": 2014,
  "season": null,
  "episode": null
}

Team Object

{
  "name": "FW",
  "releases_count": 49002,
  "total_size": 353287651737600,
  "first_release": "2018-05-15T20:31:54",
  "last_release": "2026-06-24T17:15:06"
}

💡 Use Cases

🤖

Discord Bot

Notify channels on new releases

📺

Sonarr/Radarr

Custom indexer integration

📊

Analytics Dashboard

Track scene activity trends

📡

RSS Generator

Custom feeds per team/category

📱

Mobile App

Build a native PreDB client

🔔

Alert System

Get notified for keywords/teams

📡 RSS Feed

Add ?format=rss to /api/v1/releases for RSS 2.0. Combine with filters:

https://watch.nhccloud.ca/api/v1/releases?format=rss&team=FW&api_key=YOUR_KEY
https://watch.nhccloud.ca/api/v1/releases?format=rss&cat=Movies&source=SCENE