Usenet Availability Crowdsourcing API

Check NZB availability across Usenet providers before downloading. Built by the community, for the community.

Want to start reporting? You need an API key. Join the StreamNZB Discord to request one.

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).

2

Check Availability

Query by release URL to get availability across providers, or list releases by content (IMDb ID or TVDb ID + season + episode) and optionally filter by indexer.

3

Report Status

Report the availability with release URL, release name, download link, provider hostname, and content IDs: IMDb ID for movies, or TVDb ID + season + episode for TV.

Quick Start
Get started with the AvailNZB API in minutes

1. Check availability by release URL

Use the indexer URL (GUID link) for the release.

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

2. List releases by content (IMDb / TVDb)

Ask which releases we have for a movie or TV episode. Optionally filter by indexer.

curl "http://localhost:8080/api/v1/releases?imdb_id=tt0386676"
# TV: ?tvdb_id=2710&season=2&episode=3
# Filter: &indexers=nzbgeek.info,drunken.slug

3. Report availability

Send url, release_name, size (bytes), provider_url, status, and content IDs. download_link is auto-generated from the URL. Use the X-API-Key header with your API key— request one in our Discord if you need it.

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,
    "provider_url": "news.eweka.nl",
    "status": true,
    "imdb_id": "tt0386676",
    "tvdb_id": "2710",
    "season": 2,
    "episode": 3
  }'