Your AI team, working in Shodan

Shodan provides Internet intelligence for discovering exposed devices and services, searching host data, monitoring network exposure, and consuming real-time collection feeds.

Start your company

What your team can do in Shodan

45 tools to work with, connected with an API key.

Add Alert Notifier

Attach an existing notifier to a paid Shodan network alert. This changes notification routing: future matching alert events may be delivered to the notifier's external destination. Verify both ids and the destination before calling.

Add Organization Member

Add a Shodan user to the connected Enterprise organization and upgrade their account, granting organization access. This is an administrative membership mutation. When notify is true, Shodan also sends an external email notification to the user about the invitation or access change; confirm the intended username or email address and access change before calling.

Count HostsReads only

Count hosts matching a Shodan search query and optionally return facet counts, without returning banners or consuming query credits for a plain count.

Create Network Alert

Create continuous Shodan monitoring for specified IP addresses or CIDR ranges. This paid operation changes account monitoring state and consumes monitored-IP capacity for the expanded ranges. Review the complete target set and available capacity before calling; the alert remains active until it expires or is deleted.

Create Notifier

Create a reusable Shodan notification destination. This does not affect alert routing until the notifier is attached to an alert, and it does not send a test notification. Provider arguments may contain personal contact details or secrets such as webhook URLs, routing keys, and access tokens; confirm the destination and avoid exposing these values.

Delete Network Alert

Permanently delete a Shodan network alert and stop monitoring its configured IP addresses or CIDR ranges. This destructive paid-account action cannot be undone; verify the alert id before calling it.

Delete Notifier

Permanently delete a Shodan notification service. This destructive action cannot be undone and can stop delivery for every alert that uses the notifier. Never delete the account's default notifier; verify the notifier id and its alert dependencies before calling.

Disable Alert Trigger

Disable one or more trigger rules on a paid Shodan network alert. This changes the alert configuration and prevents those trigger types from generating future alert events and notifications; verify the trigger names before calling.

Enable Alert Trigger

Enable one or more trigger rules on a paid Shodan network alert. This mutates the alert configuration and can cause future matching events to generate notifications; verify the alert id and trigger names before calling.

Get Account ProfileReads only

Return membership status, credits, display name, username, creation time, and additional profile fields for the owner of the connected Shodan API key. This response contains private account identity, contact, and subscription information; disclose or store it only when necessary.

Get API Plan InformationReads only

Return the connected API key's Shodan plan, query and scan credits, monitored-IP allowance, usage limits, and unlocked protocol features.

Get Domain InformationReads only

Return one page of subdomains and DNS records for a domain. Each lookup consumes 1 Shodan query credit and requires Shodan Membership or higher.

Get Execution Egress IPReads only

Return the public source IP address Shodan observes for this API request. When called through Composio, this is normally the outbound proxy or execution environment address, not the end user's device IP address.

Get Host InformationReads only

Return Shodan's current or historical service observations for one IP address. The main REST API host lookup requires Shodan Membership or higher.

Get Network AlertReads only

Get one Shodan network alert, including its filters, triggers, and attached notifiers. Paid monitoring capacity is required to have active alerts.

Get NotifierReads only

Get one Shodan notification service and its provider-specific destination arguments. The response can contain personal or secret routing data.

Get Observed Request HeadersReads only

Return the HTTP request headers Shodan observes for this Composio API call. Use this transport diagnostic to inspect proxy-visible request metadata, not to retrieve headers from an Internet host.

Get OrganizationReads only

Return the connected account's Shodan organization, administrators, members, member upgrade, authorized domains, and branding. This Enterprise-only response contains private usernames and email addresses. Accounts without the organization entitlement can receive an HTML 403 response, which this action reports as an entitlement error.

Get Scan StatusReads only

Return the submission or processing status of one Shodan on-demand scan. Creating on-demand scans requires a paid API plan and consumes scan credits.

Ignore Alert Service

Add one IP:port service to a Shodan network alert trigger's ignore list so matching events no longer notify. This paid-account action changes future notification behavior for the selected trigger.

List Alert TriggersReads only

List trigger rules that can be enabled on Shodan network alerts. Configuring network alerts requires paid monitoring access.

List Crawled PortsReads only

List TCP and UDP port numbers currently crawled by Shodan.

List Dataset FilesReads only

List downloadable file metadata for one Shodan bulk dataset. Bulk dataset access is an Enterprise feature; this action returns metadata and does not download the files.

List DatasetsReads only

List bulk Shodan datasets available to the connected account. Bulk data requires a Shodan Enterprise entitlement.

List Network AlertsReads only

List network alerts on the connected account, optionally including expired alerts. Accounts without monitoring capacity can return an empty list.

List Notifier ProvidersReads only

List supported notification providers and the provider-specific argument names each requires.

List NotifiersReads only

List notification services available on the connected account. Returned provider arguments can contain personal or secret destination data; do not log or expose them unnecessarily.

List Saved QueriesReads only

Return one page of community-saved Shodan search queries, with optional vote or timestamp ordering.

List Saved Query TagsReads only

List the most popular tags used by community-saved Shodan queries.

List Scan ProtocolsReads only

List protocol names and descriptions accepted by Shodan on-demand scan requests.

List ScansReads only

Return one page of active and recent on-demand scans for the connected Shodan account. Creating scans still requires credits and a paid plan.

List Search FacetsReads only

List facet names accepted by Shodan host search.

List Search FiltersReads only

List filter names accepted in Shodan host-search query syntax.

Remove Alert Notifier

Detach a notifier from a paid Shodan network alert so future matching events are no longer sent through it. This changes the alert's notification configuration but does not delete the notifier itself.

Remove Organization Member

Permanently remove a member from the connected Shodan Enterprise organization and downgrade their account. This destructive administrative action immediately changes the user's access and entitlements and cannot be undone automatically. Verify the exact username or email address and obtain explicit authorization before calling.

Request Internet Scan

Submit an Internet-wide scan for one port and protocol, initiating external network traffic and consuming scan credits. This operation is restricted to approved security researchers and Enterprise Data license holders; call it only with explicit authorization.

Request Scan

Submit an asynchronous Shodan scan for specified IP addresses or CIDR ranges. This paid operation initiates network traffic and consumes one scan credit per IP. Use it only for systems you own or have explicit authorization to assess; review the full target set before calling.

Resolve HostnamesReads only

Resolve one or more hostnames to IP addresses. Shodan Membership or higher is required. The response maps each resolved hostname to its IP address.

Reverse DNS LookupReads only

Look up hostnames for one or more IP addresses. Shodan DNS API access requires Membership or higher.

Search HostsReads only

Return one page of Shodan banners matching a query, with optional facets and field selection. Filters or pages after page 1 can consume query credits and availability varies by plan.

Search Saved QueriesReads only

Return one page of community-saved Shodan queries matching text.

Tokenize Search QueryReads only

Parse a Shodan search query into text, filters, attributes, and syntax errors without running the search.

Unignore Alert Service

Remove one IP:port service from a Shodan network alert trigger's ignore list so matching events can notify again. Requires a paid network alert.

Update Network Alert

Replace the complete IP and CIDR range list monitored by an existing Shodan network alert. This changes paid monitoring coverage and may change which future matching events generate notifications; review the full replacement list before calling.

Update Notifier

Replace provider-specific arguments for an existing Shodan notifier. This changes where future notifications are delivered and can expose notification content to an external email address, webhook, phone number, or chat service. Verify the notifier id and every destination value before calling.

More in Security & identity tools

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or