> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Securitytrails

> SecurityTrails is a cybersecurity platform providing comprehensive domain, IP, DNS, and WHOIS intelligence data. It offers historical DNS records, subdomain discovery, WHOIS history, associated domains, passive DNS datasets, and website technology detection to support threat hunting, brand protection, cyber forensics, and attack surface management.

![Securitytrails logo](https://mintcdn.com/composio-preview/YYC5iurbUCUzEs77/images/toolkits/securitytrails.svg?fit=max\&auto=format\&n=YYC5iurbUCUzEs77\&q=85\&s=e0f98f70e8a03d525449d5372a3d97da)

* **Category:** security & identity tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `SECURITYTRAILS`
* **Version:** 20261101\_00

## Tools

> [accordion] Bulk Static Asset Rules
>
> **Slug:** `SECURITYTRAILS_BULK_STATIC_ASSET_RULES`
>
> Bulk add or remove static asset rules for a SecurityTrails ASI project. Static asset rules define which domains/IPs are included or excluded from the project's monitoring scope. This operation processes up to 1000 rules (combined add + remove) per request. The API processes rules asynchronously, waiting up to 2 seconds for completion. If processing takes longer, task\_ids are returned for status polling. Note: Requires a valid project\_id from the List Projects endpoint. Use the Get Static Assets endpoint to verify changes after bulk operations complete.
>
> #### Input Parameters
>
> **add** `array`
>
> List of static asset rules to add. Each rule must include asset, membership, and static\_type
>
> **remove** `array`
>
> List of static asset rules to remove. Each rule must include asset, membership, and static\_type
>
> **project\_id** `string` *required*
>
> ASI project identifier
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Associated IPs
>
> **Slug:** `SECURITYTRAILS_GET_COMPANY_ASSOCIATED_IPS`
>
> Retrieve a page of IP addresses associated with a company domain, for identifying infrastructure linked to an organization. The response can include CIDR records and a total record count; this tool does not provide a page selection parameter.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Company domain to retrieve associated IP addresses for. Omit protocol (e.g., 'https\://') and any trailing slash.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Domain Details
>
> **Slug:** `SECURITYTRAILS_GET_DOMAIN`
>
> Retrieves comprehensive domain information from SecurityTrails including current DNS records, infrastructure details, and statistics. This tool fetches detailed DNS data (A, AAAA, MX, NS, SOA, TXT records) along with metadata about when records were first seen, which organizations own the infrastructure, and how many other domains share the same servers. Useful for domain reconnaissance, infrastructure mapping, security analysis, and understanding domain configurations. Returns structured data with typed fields for easy programmatic access by AI agents.
>
> #### Input Parameters
>
> **hostname** `string` *required*
>
> The domain/hostname to retrieve DNS and statistical data for. Must be a valid domain name without protocol or path (e.g., 'example.com', not '[https://example.com](https://example.com)'). For internationalized domain names (IDNs), use punycode encoding. Do not include trailing dots.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Domain SSL
>
> **Slug:** `SECURITYTRAILS_GET_DOMAIN_SSL`
>
> Tool to fetch current and historical SSL certificate details for a hostname. Use when you need to retrieve SSL data after identifying the domain. Coverage limited to certificates indexed by SecurityTrails; private, internally-issued, or very recently issued certificates may be absent.
>
> #### Input Parameters
>
> **hostname** `string` *required*
>
> The domain or subdomain to query for SSL certificate information. Must be a bare domain or subdomain without URL scheme or path — omit `https://`, trailing slashes, and path segments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP Search Statistics
>
> **Slug:** `SECURITYTRAILS_IP_SEARCH_STATISTICS`
>
> Fetch aggregated statistics for IP addresses matching a DSL query, including top open ports, common reverse DNS patterns, and a total count. Use it to analyze IP ranges and infrastructure patterns. IP DSL queries require a professional plan or higher.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> DSL query string for IP statistics. Supports SQL-like syntax with fields: ip (with CIDR notation), ptr\_part (reverse DNS pattern), port (numeric), and operators: =, !=, AND, OR. Use parentheses for grouping complex queries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List ASI Projects
>
> **Slug:** `SECURITYTRAILS_LIST_PROJECTS`
>
> Tool to list ASI projects available to the account. Use when you need project IDs for subsequent ASI operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ping
>
> **Slug:** `SECURITYTRAILS_PING`
>
> Tool to test authentication and connectivity with the SecurityTrails API. Use after configuring API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scroll Results
>
> **Slug:** `SECURITYTRAILS_SCROLL`
>
> Fetch the next batch of DSL search results using a scroll ID. Continue scrolling to retrieve subsequent batches.
>
> #### Input Parameters
>
> **scroll\_id** `string` *required*
>
> Identifier returned from a previous DSL search to fetch the next batch of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search IPs
>
> **Slug:** `SECURITYTRAILS_SEARCH_IPS`
>
> Search IP addresses using a SecurityTrails DSL query with page selection. IP DSL queries require a professional plan or higher.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (1-indexed). Defaults to 1.
>
> **query** `string` *required*
>
> DSL query expression to execute against SecurityTrails IP index. Supports fields: ip, ptr, ptr\_part, port.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] SQL API Execute Query
>
> **Slug:** `SECURITYTRAILS_SQL_API_EXECUTE_QUERY`
>
> Execute SQL-like queries against SecurityTrails data. Query the 'hosts' table for domain/DNS information or the 'ips' table for IP address/ASN/port data. Returns up to 100 records per request with a scroll ID for pagination. Supports standard SQL syntax (SELECT, WHERE, AND, OR, IN, IS NULL) but does NOT support LIMIT clause.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> SQL-like query string to execute. Query the 'hosts' table (domains/DNS data) or 'ips' table (IP addresses/ASN/ports). Returns max 100 records per request; use scroll ID for pagination. NOTE: LIMIT clause is not supported by the API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] SQL API Scroll Results
>
> **Slug:** `SECURITYTRAILS_SQL_API_SCROLL_RESULTS`
>
> Tool to fetch next page of SQL query results. Use after obtaining scroll\_id from initial SQL API response.
>
> #### Input Parameters
>
> **scroll\_id** `string` *required*
>
> Unique scroll identifier returned by the initial SQL API POST /query request. Use this to fetch the next page of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Temp Scrape Securitytrails Usage
>
> **Slug:** `SECURITYTRAILS_TEMP_SCRAPE_SECURITYTRAILS_USAGE`
>
> Retrieve account usage information from the SecurityTrails API. This action fetches the current monthly usage and allowed monthly usage limits for your SecurityTrails API account. Use this to monitor your API quota consumption. Returns: On success (200): - current\_monthly\_usage: Your current API usage for the month - allowed\_monthly\_usage: Your total allowed monthly API quota On error: - status\_code: HTTP status code - response\_text: Error message from API
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
