BrainPredict Communications API Reference
Complete API documentation for all 30 AI models and 50+ endpoints. RESTful API with JSON responses.
API Overview
Authentication
All API requests require authentication using your API key in the Authorization header:
curl -X POST https://api.brainpredict.ai/v1/truth/verify \
-H "Authorization: Bearer bp_communications_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"claim": "Our product is 40% faster",
"sources": ["benchmark.pdf"],
"context": "Product launch"
}'Truth Verification
/api/v1/truth/verifyVerify a truth claim with evidence analysis
/api/v1/truth/claimsGet all verified claims
/api/v1/truth/claims/{id}Get specific claim details
Brand Monitoring
/api/v1/brand/monitorStart brand monitoring with keywords
/api/v1/brand/mentionsGet brand mentions across platforms
/api/v1/brand/sentimentGet sentiment analysis results
/api/v1/brand/alertsGet active brand alerts
Crisis Detection
/api/v1/crisis/configureConfigure crisis detection settings
/api/v1/crisis/activeGet active crises
/api/v1/crisis/potentialGet potential crises
/api/v1/crisis/respondSubmit crisis response
Message Optimization
/api/v1/message/optimizeOptimize a message for engagement
/api/v1/message/analyzeAnalyze message performance
/api/v1/message/best-timeGet best time to post
Stakeholder Intelligence
/api/v1/stakeholdersGet all stakeholders
/api/v1/stakeholders/{id}Get stakeholder details
/api/v1/stakeholders/analyzeAnalyze stakeholder sentiment
Media Relations
/api/v1/media/pitchCreate media pitch
/api/v1/media/pitchesGet all media pitches
/api/v1/media/coverageGet media coverage analytics
Rate Limits
API rate limits vary by plan tier:
| Plan | Requests/Minute | Requests/Day |
|---|---|---|
| Starter | 60 | 10,000 |
| Professional | 120 | 25,000 |
| Enterprise | 300 | 100,000 |
| Custom | Unlimited | Unlimited |
Error Codes
400401429500