---
id: nextdns
version: "5.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# nextdns — Python wrapper for NextDNS API.

License: permissive · Maintenance: active · Downloads: 74.3K/mo

## What it is and what it does

nextdns is an async Python client for the NextDNS API that lets you programmatically access DNS profiles and analytics from a NextDNS account. It wraps the NextDNS service's HTTP endpoints using aiohttp for async I/O and tenacity for resilient retries, exposing methods to fetch profile details, DNS security analytics (DNSSEC, encryption), IP version breakdowns, and protocol statistics.

The package is designed for integration into monitoring tools, dashboards, or automation scripts that need to pull DNS analytics data from NextDNS. It requires an active NextDNS account and API key, and enforces Python 3.13 or later. The async-first design makes it suitable for concurrent requests or event-driven applications, though the small dependency footprint keeps installation overhead minimal.

Use it for:

- Monitor DNS security metrics and encryption status across multiple NextDNS profiles in a dashboard or alerting system.
- Automate DNS analytics collection for reporting or compliance audits tied to a NextDNS account.
- Build a Python-based DNS monitoring bot that periodically fetches profile status and protocol statistics.
- Integrate NextDNS analytics into a larger async application or microservice that manages network infrastructure.
- Retrieve and analyze DNS query protocol distribution (DoH, DoT, etc.) across your NextDNS deployment.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Async Python wrapper for the NextDNS API that retrieves DNS profiles, analytics data, and status information from a NextDNS account.

Yes, if you need programmatic access to NextDNS analytics and profiles. The package is actively maintained, has low install friction, permissive licensing, and no known vulnerabilities. The Python 3.13+ requirement is strict but aligns with modern practice. Install it if you're building monitoring or automation around NextDNS; skip it if you only need the web dashboard or don't have a NextDNS account.

## Install

pip install nextdns
uv add nextdns
poetry add nextdns

## Installing nextdns

Before you install: Low install friction with only two runtime dependencies (aiohttp and tenacity). Actively maintained with a recent release 56 days ago and current commits. Requires Python 3.13 or later, which narrows compatibility to modern versions only.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install nextdns

from aiohttp import ClientSession
from nextdns import NextDns

async with ClientSession() as session:
    nextdns = await NextDns.create(session, API_KEY)
    profile = await nextdns.get_profile(profile_id)

Requires a NextDNS account and API key; Python 3.13 or later.

Verify before relying:

- Whether the package supports DNS query filtering, blocking, or configuration beyond read-only analytics retrieval.
- Rate limiting behavior and retry strategy details beyond tenacity dependency.
- Whether analytics endpoints cover all NextDNS metrics or a subset.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 74.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nextdns api client, dns analytics python, nextdns profile management, async dns api wrapper, nextdns python library, dns status monitoring, nextdns integration, dns-monitoring, async-api-client

[View on SkillFed](https://skillfed.io/packages/nextdns) · [View on PyPI](https://pypi.org/project/nextdns/)