Tavily Integration
Connect Tavily for enhanced web research capabilities.
What is Tavily?
Tavily is a web search API designed for AI applications. It helps Z360 GTM Hub:
- Research company websites
- Validate company information
- Improve evaluation accuracy
Is It Required?
No - Tavily is optional. AI Prospecting works without it.
With Tavily: Better accuracy for borderline companies (score 6-8) Without Tavily: Faster processing, lower cost, slightly less accuracy
Setup Steps
1. Get API Key
- Go to Tavily website
- Create account or sign in
- Generate API key
2. Navigate to Settings
Go to Settings > Integrations.
3. Find Tavily Section
Look for “Tavily Integration”.
4. Enter API Key
- Paste your API key
- Click Save
- Verify connection status
Connection Status
| Status | Meaning |
|---|---|
| Connected | API key valid, working |
| Not Connected | No API key entered |
| Invalid | API key rejected |
Usage in AI Prospecting
Tavily is used by the Evaluator Agent:
- Evaluator scores company (1-10)
- For uncertain scores (6-8), Evaluator requests web research
- Tavily searches company website/news
- Evaluator re-evaluates with research
- Final score assigned
Usage Limits
Default limit: 50 Tavily lookups per AI Prospecting session
This can be adjusted in Settings > AI Prospecting under “Max Tavily Lookups”.
Cost Considerations
Tavily charges per API call. Monitor usage:
- Session reports show Tavily calls made
- Reduce max lookups to lower costs
- Disable for cost-sensitive sessions
Disconnecting
To remove Tavily:
- Clear API key field
- Click Save
- Status changes to “Not Connected”
AI Prospecting continues without web research.
Troubleshooting
| Issue | Solution |
|---|---|
| Invalid API key | Regenerate key from Tavily |
| Rate limited | Wait and retry, or upgrade plan |
| No results | Check company website exists |