REST API
Programmatic access to Hacker Bot functionality.
Base URL
https://api.hackerbot.io/v1 Authentication
Include your API key in the Authorization header:
curl -H "Authorization: Bearer hb_your_api_key" \
https://api.hackerbot.io/v1/scansEndpoints Overview
| Method | Endpoint | Description |
|---|---|---|
| GET | /scans | List all scans |
| POST | /scans | Create a new scan |
| GET | /scans/:id | Get scan details |
| GET | /scans/:id/findings | List findings for a scan |
| GET | /findings | List all findings |
| GET | /findings/:id | Get finding details |
| GET | /projects | List projects |
Rate Limits
API requests are rate limited based on your plan:
- Starter: 100 requests/minute
- Pro: 500 requests/minute
- Enterprise: Custom limits
Rate limit headers are included in every response.
Error Handling
Errors return appropriate HTTP status codes:
{
"error": {
"code": "invalid_api_key",
"message": "The provided API key is invalid or expired",
"status": 401
}
}