Skip to main content

BrainPredict Strategy API Reference

Complete API documentation for BrainPredict Strategy. All endpoints require authentication using your API key.

Authentication

All API requests require authentication using your API key in the Authorization header:

Authorization: Bearer bp_strategy_live_1234567890abcdef1234567890abcdef

Base URL

https://api.brainpredict.ai/v1

API Endpoints

GET/api/strategy/ai/models

List all 28 available Strategy AI models with their capabilities and accuracy rates

Response Example:
{
  "total": 28,
  "models": [
    {
      "id": "strategic_goal_optimizer",
      "name": "Strategic Goal Optimizer",
      "accuracy": 0.92
    }
  ]
}
POST/api/strategy/ai/strategic-goal-optimizer

Optimize strategic goals with AI-powered recommendations

Parameters:
goal_nametarget_revenuetimeline_monthscurrent_resourcesconstraintsrisk_tolerance
Response Example:
{
  "ai_score": 87,
  "success_probability": 82,
  "expected_revenue": 124000000,
  "recommendations": []
}
POST/api/strategy/ai/market-trend-forecaster

Forecast market trends 3-5 years ahead

Parameters:
industrygeographytime_horizon_years
Response Example:
{
  "trends": [
    {
      "trend": "AI Integration",
      "growth": 0.47,
      "impact": "critical",
      "timeline": "12-18 months"
    }
  ]
}
POST/api/strategy/ai/competitor-move-predictor

Predict competitor actions with 84% accuracy

Parameters:
competitor_nametime_horizon_months
Response Example:
{
  "predicted_moves": [
    {
      "action": "acquisition",
      "probability": 0.87,
      "timeline": "Q1 2025"
    }
  ]
}
POST/api/strategy/ai/mna-target-identifier

Identify M&A targets with synergy analysis

Parameters:
industryrevenue_rangegeographystrategic_fit_criteria
Response Example:
{
  "targets": [
    {
      "name": "AI Innovations Ltd",
      "ai_score": 94,
      "synergy": 87,
      "success_probability": 82
    }
  ]
}
POST/api/strategy/ai/resource-allocation-optimizer

Optimize resource allocation across departments

Parameters:
total_budgetdepartmentsconstraintsobjectives
Response Example:
{
  "allocations": [
    {
      "department": "R&D",
      "current": 97000000,
      "optimal": 112000000,
      "delta": 0.15
    }
  ],
  "total_impact": 66000000
}
POST/api/strategy/ai/long-term-revenue-forecaster

Forecast revenue 3-5 years ahead with confidence intervals

Parameters:
historical_datatime_horizon_yearsgrowth_assumptions
Response Example:
{
  "forecasts": [
    {
      "year": 2025,
      "forecast": 524000000,
      "confidence": 0.94,
      "range": "€498M - €547M"
    }
  ]
}
POST/api/strategy/ai/strategic-risk-predictor

Predict strategic risks with mitigation recommendations

Parameters:
strategic_goalsmarket_conditionscompetitive_landscape
Response Example:
{
  "risks": [
    {
      "risk": "Competitor AI Product Launch",
      "probability": 0.87,
      "impact": "high",
      "mitigation": []
    }
  ]
}
POST/api/strategy/ai/blue-ocean-identifier

Identify blue ocean opportunities in untapped markets

Parameters:
current_marketscapabilitiesinnovation_potential
Response Example:
{
  "opportunities": [
    {
      "market": "AI-Powered Healthcare",
      "attractiveness": 92,
      "entry_barriers": "medium"
    }
  ]
}
POST/api/strategy/ai/scenario-simulator

Simulate strategic scenarios with Monte Carlo analysis

Parameters:
scenario_namevariablesconstraintssimulation_runs
Response Example:
{
  "outcomes": [
    {
      "scenario": "Best Case",
      "probability": 0.25,
      "revenue": 650000000
    }
  ]
}
GET/api/strategy/goals

List all strategic goals

Parameters:
statuspriorityowner
Response Example:
{
  "total": 12,
  "goals": [
    {
      "id": "SG-001",
      "name": "Expand into Asian Markets",
      "status": "on_track"
    }
  ]
}
POST/api/strategy/goals

Create a new strategic goal

Parameters:
namedescriptiontarget_dateownerkpis
Response Example:
{
  "id": "SG-013",
  "name": "Launch AI Product Line",
  "created_at": "2025-11-20T10:00:00Z"
}
GET/api/strategy/initiatives

List all strategic initiatives

Parameters:
goal_idstatusowner
Response Example:
{
  "total": 34,
  "initiatives": [
    {
      "id": "SI-001",
      "name": "Market Research Asia",
      "status": "in_progress"
    }
  ]
}
GET/api/strategy/competitors

List all tracked competitors

Parameters:
industrymarket_share_min
Response Example:
{
  "total": 8,
  "competitors": [
    {
      "id": "COMP-001",
      "name": "GlobalTech Solutions",
      "market_share": 0.187
    }
  ]
}
GET/api/strategy/scenarios

List all strategic scenarios

Parameters:
statuscreated_after
Response Example:
{
  "total": 15,
  "scenarios": [
    {
      "id": "SC-001",
      "name": "Market Expansion Scenario",
      "status": "active"
    }
  ]
}

Rate Limits

Starter Plan: 1,000 requests/hour

Professional Plan: 5,000 requests/hour

Enterprise Plan: 20,000 requests/hour

Custom Plan: Unlimited requests

Rate limit headers are included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Error Codes

CodeHTTP StatusDescription
INVALID_REQUEST400Invalid request parameters
UNAUTHORIZED401Invalid or missing API key
RATE_LIMIT_EXCEEDED429Rate limit exceeded
MODEL_ERROR500Internal model error
SERVICE_UNAVAILABLE503Service temporarily unavailable

SDKs

Official SDKs are available for Python, Node.js, Java, and PHP:

# Python
pip install brainpredict-strategy

# Node.js
npm install @brainpredict/strategy

# Java
mvn install brainpredict-strategy

# PHP
composer require brainpredict/strategy

Ready to Start Building?

Get your API key and start using BrainPredict Strategy today.