.card img{
  scale: 0.6;
}

/* Works on Firefox */
* {
  scrollbar-width: thin;
  scrollbar-color: #ffffff4d #303030;
}

/* Works on Chrome, Edge, and Safari */
*::-webkit-scrollbar {
  width: 12px;
}

*::-webkit-scrollbar-track {
  background: #303030;
}

*::-webkit-scrollbar-thumb {
  background-color: #ffffff4d;
  border-radius: 20px;
  border: 3px solid #303030;
}

Retrieve all scans that match the specified query filter.

Query Scans

Contains detailed information about the scan, including URL submission details, scan status, and various scan-related metadata.

The type of device selected for the scan, either 'DESKTOP' or 'MOBILE'.

The height of the viewport used during the scan in pixels.

Unique, autogenerated identifier for the scan.

Indicates whether the content of the page contains Not Safe For Work (NSFW) material, such as nudity or adult content.

Indicates whether the scan was submitted via the API or by a user.

If true, the scan results are only accessible by the user who submitted the scan.

The protocol of the URL, such as HTTP or HTTPS.

The country from which the scan was initiated. Available only for PREMIUM users.

The current status of the scan. 'PENDING' and 'RUNNING' are intermediate states, while 'DONE' and 'ERROR' are final states.

The date and time when the scan was submitted.

The URL provided by the user to be scanned.

A list of any tags associated with the scan, submitted by the user.

The final URL after any redirection (if applicable).

The user agent string associated with the device for simulating the browser environment.

The width of the viewport used during the scan in pixels.

ApiKeyAuth

List of matching scans, sorted by submission date in descending order.

Internal Server Error - Unexpected error occurred.

Unauthorized - API key is missing or invalid.

Get scans matching query filter

urlDNA - Documentation

Introduction

Scan

Search

My Queries

Brand Monitor

Takedown

AI Playground

Welcome to the urlDNA API documentation. This API allows you to scan, analyze, and retrieve insights about URLs, helping to detect potential threats such as phishing, malware, and scams.

You can obtain your API key from your urlDNA account page.

Authentication

Understand how API usage is counted and what your daily limits are.

API Quotas & Limit

The urlDNA Python package allows you to interact with the URLDNA API for scanning and analyzing URLs. With this package, you can retrieve scan results, extract metadata, and detect potential threats. 

Python Package

Initiate a new scan request. The response will contain the Scan object. Processing time varies based on system load (typically between 30 seconds and 1 minute) before the full scan result becomes available.

Create Scan

Fetch the details of a specific scan. If the scan status is PENDING or RUNNING, all attributes (except the scan metadata) will be empty.

Get Scan

Search for existing scan results using a query string or CQL (see the Search documentation for more details).

Quickly assess whether a given URL is SAFE or MALICIOUS.

Fast Check

Provide feedback on the scan verdict. The feedback can either classify the scan as MALICIOUS or SAFE.

Scan Feedback

Fetch a list of user agents that can be used for scanning.

User Agents

Fetch a list of supported viewport dimensions for scans.

Viewports

Retrieve a list of query objects associated with the user.

Queries

Retrieve details of a specific query object by ID.

Get Query

Create a new query object. The request must include a name and a list of query filters.

Create Query

Update an existing query object. The request must include a name and a list of query filters.

Updated Query

Delete Query

Retrieve all brands associated with the user. This endpoint is only available for PREMIUM users.

Brands

Retrieve details of a specific chat object. This endpoint is only available for PREMIUM users.

Get Brand

Retrieve all scans associated with a specific brand. This endpoint is only available for PREMIUM users.

Brand Scans

Retrieve a list of all chat objects associated with the user. This endpoint is only available for PREMIUM users.

Chats

Get Chat

Create a new chat object. This endpoint is only available for PREMIUM users.

Create Chat

Delete a specific chat object. This endpoint is only available for PREMIUM users.

Delete Chats

Cyber Threat Intelligence

Security Operation Center

Brand Monitoring

urlDNA empowers your security operations by seamlessly integrating into your workflows for efficient analysis and triaging of suspicious URLs. Simplify your processes and enhance your defenses with our robust API. Visit our API Documentation to learn how to integrate urlDNA into your environment effortlessly. 

API Documentation

Endpoints

Query Scans

Authorizations

Path Parameters

Response