Bot Detector analyzes user agent strings to identify bots, crawlers, and automated software. It matches against a database of known bots and adds heuristics that catch automated clients not in the database, returning the bot's category, reputation and a composite risk score. Useful for security, analytics, and access control.
The Bot Detector API provides a simple, reliable way to integrate bot detector functionality into your applications. Built for developers who need production-ready bot detector capabilities without the complexity of building from scratch.
Quick Start
Using JavaScript
async function callBotDetectorAPI() {
try {
const params = new URLSearchParams({
ua: 'Googlebot/2.1 (+http://www.google.com/bot.html)'
});
const response = await fetch(`https://api.apiverve.com/v1/botdetector?${params}`, {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
});
const data = await response.json();
console.log(data);
} catch (error) {
console.error('Error:', error);
}
}
callBotDetectorAPI();Using cURL
curl -X GET "https://api.apiverve.com/v1/botdetector?ua=Googlebot%2F2.1%20(%2Bhttp%3A%2F%2Fwww.google.com%2Fbot.html)" \
-H "x-api-key: YOUR_API_KEY_HERE"Get your API key: https://apiverve.com
📁 For more examples, see the examples folder
Installation
Choose your preferred programming language:
📦 NPM (JavaScript/Node.js)
npm install @apiverve/botdetectorView NPM Package → | Package Code →
🔷 NuGet (.NET/C#)
dotnet add package APIVerve.API.BotDetectorView NuGet Package → | Package Code →
🐍 Python (PyPI)
pip install apiverve-botdetectorView PyPI Package → | Package Code →
💎 Ruby (RubyGems)
gem install apiverve_botdetectorView RubyGems Package → | Package Code →
🐘 PHP (Packagist)
composer require apiverve/botdetectorView Packagist Package → | Package Code →
🎯 Dart (pub.dev)
dart pub add apiverve_botdetectorView pub.dev Package → | Package Code →
🤖 Android (JitPack)
implementation 'com.github.apiverve:botdetector-api:1.0.0'🐹 Go
go get github.com/apiverve/botdetector-api/goWhy Use This API?
| Feature | Benefit |
|---|---|
| Multi-language SDKs | Native packages for JavaScript, Python, C#, Go, and Android |
| Simple Integration | Single API key authentication, consistent response format |
| Production Ready | 99.9% uptime SLA, served from 24 global regions |
| Comprehensive Docs | Full examples, OpenAPI spec, and dedicated support |
Documentation
- 🏠 API Home: Bot Detector API
- 📚 API Reference: docs.apiverve.com/ref/botdetector
- 📖 OpenAPI Spec: openapi.yaml
- 💡 Examples: examples/
What Can You Build?
The Bot Detector API is commonly used for:
- Web Applications - Add bot detector features to your frontend or backend
- Mobile Apps - Native SDKs for Android development
- Automation - Integrate with n8n, Zapier, or custom workflows
- SaaS Products - Enhance your product with bot detector capabilities
- Data Pipelines - Process and analyze data at scale
API Reference
Authentication
All requests require an API key in the header:
x-api-key: YOUR_API_KEY_HERE
Get your API key: https://apiverve.com
Response Format
Every APIVerve endpoint returns the same envelope — check status, then read data:
{
"status": "ok",
"error": null,
"data": { ... }
}Example Response
A real response from the Bot Detector API:
{
"status": "ok",
"error": null,
"data": {
"userAgent": "Googlebot/2.1 (+http://www.google.com/bot.html)",
"isBot": true,
"bot": {
"name": "Googlebot",
"category": "search_engine",
"url": "http://www.google.com/bot.html",
"reputation": "trusted",
"shouldBlock": false
},
"isAutomated": true,
"riskScore": 0,
"riskLevel": "low"
}
}Support & Community
- 🏠 API Home: Bot Detector API
- 💬 Support: https://apiverve.com/contact
- 🐛 Issues: GitHub Issues
- 📖 Documentation: https://docs.apiverve.com
- 🌐 Website: https://apiverve.com
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Security
For security concerns, please review our Security Policy.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Built with ❤️ by APIVerve
Copyright © 2026 APIVerve. All rights reserved.