Skip to main content

Documentation Status

Client API for PDNS

Client API to query any Passive DNS implementation following the Passive DNS - Common Output Format.

Installation

pip install pypdns

Usage

Command line

You can use the pdns command to trigger a request.

usage: pdns [-h] --username USERNAME --password PASSWORD --query QUERY [--rrtype RRTYPE]

Triggers a request againse CIRCL Passive DNS.

options:
  -h, --help           show this help message and exit
  --username USERNAME  The username of you account.
  --password PASSWORD  The password of you account.
  --query QUERY        The query, can be an IP. domain, hostname, TLD.
  --rrtype RRTYPE      Filter the request based on the RR Type.

Library

See API Reference

Example

import pypdns
import json
x = pypdns.PyPDNS(basic_auth=('username','yourpassword'))

for record in x.iter_query(q='circl.lu', filter_rrtype='A'):
    print(json.dumps(record.record, indent=2))

Passive DNS Services

Release files for pypdns 2.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pypdns 2.3.2
File Size Uploaded
pypdns-2.3.2.tar.gz 7.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pypdns 2.3.2
File Interpreter ABI Platform
pypdns-2.3.2-py3-none-any.whl Python 3 none any Details

Total release size: 16.1 kB

Release files / pypdns-2.3.2.tar.gz

Download URL pypdns-2.3.2.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
53a9e702635e91c14cdd0c24400912902c69889cfca7886d5b976c9337a48f7c
BLAKE2b-256 checksum
How to use checksums
1285aa919e94b24c75189441821e0873d8d59a13d56f3597dfc02ec886513f22
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 18, 2026.

Transparency log

Release files / pypdns-2.3.2-py3-none-any.whl

Download URL pypdns-2.3.2-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d677c4ffe4504a3cb2e77a483e4433d638d4e5051241c37b41363b62ad592da
BLAKE2b-256 checksum
How to use checksums
bc5dfe63d839150d40e4abd3626d3f75b3f0ae85420d0689eb1a3b8d0cbb8330
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 18, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.3.2 This release

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.8

2 release files

2.2.7

2 release files

2.2.6

2 release files

2.2.5

2 release files

2.2.3

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.6.0

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5

2 release files

1.4.1

2 release files

1.4

2 release files

1.3

1 release file

1.2

1 release file

1.1.1

1 release file

1.1

1 release file

1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page