# urlDNA - Documentation ## Docs - [API Quotas & Limit](https://docs.urldna.io/api-reference/api-usage.md): Understand how API usage is counted and what your daily limits are. - [Authentication](https://docs.urldna.io/api-reference/authentication.md): You can obtain your API key from your urlDNA account page. - [API Usage](https://docs.urldna.io/api-reference/endpoint/api-usage.md): Returns the authenticated user's daily API quota limit, current consumption, and remaining requests. - [Brand Scans](https://docs.urldna.io/api-reference/endpoint/brand-scans.md): Retrieves all scans associated with a specific brand. Supports additional CQL filtering to narrow results. Returns scans sorted by submission date descending. - [Brands](https://docs.urldna.io/api-reference/endpoint/brands.md): Retrieves brands available to the user for monitoring brand-related scans. Supports filtering by visibility level and searching by name. - [Create Query](https://docs.urldna.io/api-reference/endpoint/create-query.md): Creates a new saved query with custom filter conditions. Queries enable complex, reusable searches across scan attributes using logical AND combinations of filters. - [Create Scan](https://docs.urldna.io/api-reference/endpoint/create-scan.md): Initiates a new URL scan with customizable parameters. Returns a Scan object immediately with status PENDING. Processing typically completes within 30-60 seconds depending on system load. Poll the GET /v1/scan/ endpoint to retrieve full results once status is DONE. - [Delete Query](https://docs.urldna.io/api-reference/endpoint/delete-query.md): Permanently deletes a saved query. This operation cannot be undone. - [Fast Check](https://docs.urldna.io/api-reference/endpoint/fast-check.md): Quickly assesses URL safety without performing a full scan. Returns malicious score and classification (SAFE, MALICIOUS, or UNRATED) based on existing intelligence and heuristics. Ideal for real-time URL validation. - [Get Brand](https://docs.urldna.io/api-reference/endpoint/get-brand.md): Retrieve detailed information about a specific brand. - [Get Query](https://docs.urldna.io/api-reference/endpoint/get-query.md): Retrieves complete details for a specific saved query including all filter conditions. - [Get Scan](https://docs.urldna.io/api-reference/endpoint/get-scan.md): Fetches complete scan results for a specific scan ID. Returns scan metadata immediately; full results (certificate, screenshot, etc.) are available once status is DONE. Scans in PENDING or RUNNING states return metadata only. - [Queries](https://docs.urldna.io/api-reference/endpoint/queries.md): Retrieves all saved query objects for the authenticated user. Queries encapsulate reusable filter combinations for consistent scan searching. - [Query Scans](https://docs.urldna.io/api-reference/endpoint/query-scans.md): Executes a saved query and returns all matching scans sorted by submission date descending. Applies all filter conditions defined in the query. - [Search](https://docs.urldna.io/api-reference/endpoint/search.md): Searches the scan database using query strings or CQL (Custom Query Language). Returns matching scans sorted by submission date descending. Supports complex filtering across multiple scan attributes. See documentation for CQL syntax details. - [Update Query](https://docs.urldna.io/api-reference/endpoint/update-query.md): Update the name or filters of an existing saved query. - [User](https://docs.urldna.io/api-reference/endpoint/user.md): Returns the authenticated user. - [User Agents](https://docs.urldna.io/api-reference/endpoint/user-agent.md): Returns a curated list of user agent strings that can be used when submitting scans. Each user agent includes browser type, device category, and market share data to help select realistic scanning profiles. - [Viewports](https://docs.urldna.io/api-reference/endpoint/viewport.md): Returns recommended viewport dimensions for both desktop and mobile scans. Use these dimensions to ensure consistent rendering across scans and match common device resolutions. - [Examples](https://docs.urldna.io/api-reference/example.md) - [Introduction](https://docs.urldna.io/api-reference/introduction.md): 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. - [Python Package](https://docs.urldna.io/api-reference/python.md): 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. - [AI Agent](https://docs.urldna.io/docs/ai-agent.md) - [Brand Monitor](https://docs.urldna.io/docs/brand-monitor.md) - [Scan Graph](https://docs.urldna.io/docs/graph.md) - [Introduction](https://docs.urldna.io/docs/introduction.md): Welcome to urlDNA documentation - [My Queries](https://docs.urldna.io/docs/my-queries.md) - [Scan](https://docs.urldna.io/docs/scan.md) - [Search](https://docs.urldna.io/docs/search.md) - [Takedown](https://docs.urldna.io/docs/takedown.md) - [Integrations](https://docs.urldna.io/integrations/integration.md): 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 eff… - [Brand Monitoring](https://docs.urldna.io/use-cases/brand-monitoring.md) - [Cyber Threat Intelligence](https://docs.urldna.io/use-cases/cyber-threat-intelligence.md) - [Security Operation Center](https://docs.urldna.io/use-cases/security-operation-center-integration.md) ## OpenAPI Specs - [openapi](https://docs.urldna.io/api-reference/openapi.json)