Home
Get Started
API Usage Guides
Use Cases
Developer Tools
Integrations
Community
API ExplorerAPI Reference
Use Cases

Power Your AI Agents

AI agents are powerful, but their knowledge is often limited to their training data. They can't see the internet as it is right now. The Whisper API solves this by acting as the agent's eyes and ears, providing structured, real-time data about any domain or IP address on demand.

How it Works: The API as a Tool

‍

In modern AI frameworks like LangChain or with OpenAI's function calling, you can define "tools" that an agent can decide to use to answer a question. The Whisper API endpoints are perfect tools for any agent tasked with internet investigation.

An agent's reasoning process might look like this:

  1. User Prompt: "Investigate the domain suspicious-login.net and its infrastructure."
  2. Agent Thought: "My first step is to get general information about this domain. I will use the get_domain_intelligence tool."
  3. Agent Action: The agent calls GET /intelligence/v1/domain/suspicious-login.net.
  4. Agent Observation: The agent receives the JSON response. It sees the domain resolves to IP 4.5.6.7 and was created yesterday.
  5. Agent Thought: "Now I need to understand the reputation of the IP 4.5.6.7. I will use the get_ip_intelligence tool."
  6. Agent Action: The agent calls GET /intelligence/v1/ip/4.5.6.7.
  7. Agent Observation: The agent sees the IP has a high risk_score and is linked to other suspicious domains.
  8. Final Answer: The agent synthesizes these findings into a human-readable summary, concluding that the domain is high-risk.

‍