urlDNA

official stdio

Dynamically scan and analyze potentially malicious URLs using the urlDNA.io

Install

pip install uv

fast_check Instantly check if a URL has been scanned. Returns SAFE / MALICIOUS / UNRATED.
new_scan Submit a URL for a full scan and wait for the result (~30–60s).
get_scan Retrieve a complete scan result by ID.
search Search scans using CQL (Custom Query Language) across domain, IP, technology, malicious flag, and more. Supports pagination (page 2+ requires PREMIUM).
list_queries List all saved queries for the authenticated user.
get_query Retrieve a specific saved query and its filters by ID.
create_query Create a new saved query with one or more CQL filter conditions.
update_query Update an existing query's name and filters (full replacement).
delete_query Permanently delete a saved query by ID.
query_scans Retrieve all matching scans for a saved query.
list_brands List available brands with optional name search and visibility filter (ALL / FREE / PREMIUM / USER_BRANDS).
get_brand Retrieve full details of a specific brand by ID.
brand_scans Get all scans associated with a brand. Supports additional CQL filtering.
search_docs Fetch the full urlDNA OpenAPI and documentations.

★ 7 GitHub stars