Usenet Availability Crowdsourcing API

Check NZB availability across Usenet providers before downloading. Built for developer integrations and community-powered reporting.

AvailNZB is a developer-focused API. Generate or recover your app key from the Swagger docs, then use X-API-Key for authenticated requests.

Features

Real-time Availability
Check if NZB files are available on specific Usenet providers before downloading

Get instant feedback on file availability across multiple providers, saving bandwidth and time.

Crowdsourced Data
Community-driven reports ensure accurate and up-to-date availability information

Users report availability status, creating a comprehensive database that benefits everyone.

Content-based Lookup
Query releases by IMDb ID (movies) or TVDb ID + season + episode (TV)

Ask which releases we have for a title. Filter by indexer and see availability per provider.

Optimistic Health Model
Designed for streaming with intelligent availability detection

A single success report proves file existence. Failures may be user-specific issues.

Failure Reports
DMCA takedowns surface as failure reports when users try and fail

Bad or removed releases get reported by the community, keeping availability data accurate over time.

RESTful API
Simple, well-documented REST API with OpenAPI/Swagger support

Easy integration with any language or framework. Full API documentation available.

How It Works

1

Identify the release

Use the indexer's release URL (the GUID link) as the identifier. Content is tagged with IMDb ID (movies) or TVDb ID + season + episode (TV).

Check availability by URL

curl "http://localhost:8080/api/v1/status/url?url=https%3A%2F%2Fnzbgeek.info%2Fgeekseek.php%3Fguid%3D..."
2

Query releases by content

List releases by IMDb ID (movies) or TVDb ID + season + episode (TV). Responses include availability summaries keyed by backbone (Omicron, Eweka, etc.). Use GET /backbones to map provider hostnames to backbones.

# Movie
curl "http://localhost:8080/api/v1/status/imdb/tt0386676"
# TV episode
curl "http://localhost:8080/api/v1/status/tvdb/2710/2/3"
# Filter by indexers: ?indexers=nzbgeek.info,drunken.slug
# Filter by backbones: ?providers=news.eweka.nl,news.newshosting.com
3

Report availability

Submit reports with url, release_name, size, compression_type, provider_url (NNTP hostname), status, and content IDs. Use X-API-Key—generate or recover credentials in the Swagger docs.

NNTP validation before reporting

Validate segments on the NNTP server before reporting success: STAT sample segments (existence check) → BODY + yEnc decode on first/middle/last segments (data integrity) → archive header verification for RAR/7z (streamability check).

curl -X POST http://localhost:8080/api/v1/report \
  -H "X-API-Key: your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://nzbgeek.info/geekseek.php?guid=...",
    "release_name": "Show.Name.S01E02.720p.WEB.x264-GROUP",
    "size": 1073741824,
    "compression_type": "rar",
    "provider_url": "news.eweka.nl",
    "status": true,
    "imdb_id": "tt0386676"
  }'