urlDNA
urlDNA is a powerful tool for comprehensive URL analysis, advanced brand monitoring, phishing detection, and custom query capabilities. This Python package allows users to interact with the urlDNA API seamlessly through Python.
Features
- Create Scan: Initiate a new scan for a given URL.
- Search: Perform a search query to find relevant data.
- Get Scan: Retrieve the results of a all scans.
- Viewports: All available viewports by device.
- User Agents: All available user agents.
- Fast Check: Check if an URL is CLEAN or MALICIOUS (beta).
Installation
To install the urlDNA Python package, use pip:
pip install urldna
Usage
Installation
First, import the package and initialize the client with your API key:
from urldna import UrlDNA
# Initialize the client with your API key
api_key = 'YOUR_API_KEY'
client = UrlDNA(api_key)
Create Scan
Initiate a new scan for a given URL to analyze its content and metadata.
# Create a scan for a URL
url = 'https://example.com'
scan_result = client.create_scan(url)
print(f'Scan ID: {scan_result.scan.id}')
Search
Perform a search query using Custom Query Language to find relevant data.
# Perform a search query
query = 'domain LIKE google.com'
search_results = client.search(query)
print(search_results)
Get Scan
Retrieve the results of a previously initiated scan using its scan ID.
# Get scan results
scan_id = 'your_scan_id'
scan_result = client.get_scan(scan_id)
print(scan_result)
Viewports
List of all available viewports (device, height, width)
viewports = client.viewports()
print(viewports)
Viewports
List of all available user agents (browser, device, user_agent)
user_agents = client.user_agents()
print(user_agents)
Fast check
Check if an URL is CLEAN or MALICIOUS (beta).
fast_check = client.fast_check("https://google.com")
print(fast_check)
API Reference
for all API details, please viti the API Documentation page.
UrlDNA(api_key)
- Initializes the client with the provided API key. Copy your API key from Profile page.
Methods
create_scan(url, device='DESKTOP', width=1920, height=1080, user_agent=None, waiting_time=5, private_scan=False): Initiates a scan for the given URL and returns a scan ID.search(query): Performs a search based on the given query and returns the results.get_scan(scan_id): Retrieves the results of the scan identified by the given scan ID.
Contributing
Contributions are welcome! Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Commit your changes (
git commit -am 'Add new feature'). - Push to the branch (
git push origin feature-branch). - Create a new Pull Request.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Support
For any issues or questions, please contact urldna@urldna.io.
Acknowledgements
Thank you for using urlDNA! We hope our tool helps you gain valuable insights into your URLs and online presence.
Metadata
Release files for urlDNA 0.0.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| urldna-0.0.21.tar.gz | 11.0 kB | Without provenance | Details for urldna-0.0.21.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| urldna-0.0.21-py3-none-any.whl | Python 3 | none | any | Details for urldna-0.0.21-py3-none-any.whl |
Total release size: 32.3 kB
Release files / urldna-0.0.21.tar.gz
| Download URL | urldna-0.0.21.tar.gz |
|---|---|
| Size | 11.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c4814f5e336990d666a0ae85a64d8d4d5c3aaaf9e2435d1b0064f9ca347420ea
|
|
BLAKE2b-256 checksum How to use checksums |
cf4f4259dda79e4687f4fe4d1dbb579fe5c90adb8994478d98f57b1912b639f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / urldna-0.0.21-py3-none-any.whl
| Download URL | urldna-0.0.21-py3-none-any.whl |
|---|---|
| Size | 21.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3436c25ef21797fe1535b620337335b814eafc000c9428cb71b34dc473021ce4
|
|
BLAKE2b-256 checksum How to use checksums |
563fe2f553478dc451395e93f74062c994c312cbfcf4431893e2f6082f7218ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for urlDNA 0.0.21
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.