Developer docs
Documentation
Guides and API reference for running AntiBait analysis from the web app or from your own code.
API reference
Bulk analysis API
Pro+Analyze multiple emails in a single API call for rapid batch threat scoring. Supports up to 25 emails per request with two model tiers.
API endpoint
POST/api/analysis/bulkRequest body
{
"emails": [
{
"email": "string (raw email)",
"label": "string (optional)"
}
],
"model": "bulk"
}Max 25 emails per request. Each email max 500KB. Total payload max 5MB.
Response
{
"success": true,
"totalEmails": number,
"processed": number,
"cached": number,
"failed": number,
"model": "bulk",
"results": [
{
"index": number,
"label": string | null,
"success": boolean,
"cached": boolean,
"analysisId": "uuid" | null,
"score": 0-100,
"type": string | null,
"confidence": 0-100 | null,
"tags": string[],
"error": string | null
}
]
}Available models
Bulk
1x usageFast batch analysis for high-volume scanning and initial triage.
Best for: High-volume scanning, initial triage
What's included
Threat scoring
0–100 risk score for each email
Type classification
Phishing, malicious, spam, or legitimate
Confidence rating
0–100% confidence in the classification
Security tags
Relevant threat indicators and classifications
Smart deduplication
Previously analyzed emails return cached results instantly
IOC extraction
Indicators of Compromise are automatically extracted and stored
Not included (use full analysis)
Detailed reasoning
Use /api/analysis/advanced for explanations
False positive checks
Bulk mode omits false positive analysis
Industry-specific tuning
Available in single-email analysis on every model
Deep URL analysis
Blacklist checking not included in bulk mode
Limits and rate limiting
| Limit | Pro | Business | Enterprise |
|---|---|---|---|
| Emails per request | 25 | 25 | 25 |
| Bulk requests/min | 5 | 15 | 30 |
| Monthly bulk scans | 10 | 50 | Unlimited |
| Max email size | 500KB | 500KB | 500KB |
| Max total payload | 5MB | 5MB | 5MB |
Example: cURL
curl -X POST https://antibait.io/api/analysis/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"emails": [
{ "email": "From: ...\nTo: ...\nSubject: ...\n\nBody...", "label": "email-1" },
{ "email": "From: ...\nTo: ...\nSubject: ...\n\nBody...", "label": "email-2" }
],
"model": "bulk"
}'Need help integrating the API? The support team replies within 24 hours on business days.