How to use AvailNZB
This API is built for apps that check playback results and report real-world availability. Start with key setup, then report outcomes consistently to build trust.
1) Create or recover a key
Create with POST /api/v1/keys/roll_key. Recover with POST /api/v1/keys/recover (IP or token match).
2) Check status
Use URL checks and metadata routes to decide what to play. Add provider/indexer filters when needed.
curl "https://snzb.stream/api/v1/status/url?url=https%3A%2F%2Fnzbgeek.info%2Fgeekseek.php%3Fguid%3D..."
curl "https://snzb.stream/api/v1/status/imdb/tt0386676"3) Report what actually happened
If the stream plays, report status: true. If it fails to play, report status: false. Do not guess; report real playback outcomes from your client.
curl -X POST https://snzb.stream/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,"tmdb_id":"875828"}'4) Monitor app status
Track key health and trust metrics with GET /api/v1/me.
What trust means
Each key has a trust_level and trust_score. These change as your reports are processed.
How it changes
Consistent, useful report history improves trust. Unreliable patterns can reduce trust or keep you at lower visibility.
What low trust looks like
Metadata-based routes can return limited or empty results while trust is low. URL-based checks and report submission remain available.
How to diagnose quickly
Use /api/v1/me to inspect counts, decisions, and trust state for the current key.
curl -H "X-API-Key: your-api-token" https://snzb.stream/api/v1/me