API Documentation

Generate comprehensive business plans programmatically using the BluePrintX AI API.

Quick Start

API Tokens

Use one of these static tokens for authentication:

bpx_live_1234567890abcdef

bpx_test_0987654321fedcba

Endpoint

POST/api/generate

Generate a comprehensive business plan including costs, marketing strategy, revenue projections, branding, competitors, roadmap, and tips.

Authentication

Include your API token in the Authorization header using the Bearer scheme:

Authorization: Bearer YOUR_API_TOKEN

Request Body

Parameter	Type	Required	Description
businessIdea	string	Yes	Description of your business idea (e.g., "AI-powered fitness coaching app")

Code Examples

cURL

curl -X POST https://bpx-ai.com/api/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "businessIdea": "AI-powered fitness coaching app"
  }'

JavaScript / Node.js

const response = await fetch('https://bpx-ai.com/api/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  body: JSON.stringify({
    businessIdea: 'AI-powered fitness coaching app'
  })
});

const data = await response.json();
console.log(data);

Python

import requests

url = "https://bpx-ai.com/api/generate"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
    "businessIdea": "AI-powered fitness coaching app"
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print(result)

Response

Success Response (200)

{
  "success": true,
  "data": {
    "businessIdea": "AI-powered fitness coaching app",
    "totalStartup": 45000,
    "totalMonthly": 8500,
    "recommendedInvestment": 96000,
    "timeline": "12-18 months",
    "startupCosts": [
      {
        "name": "App Development",
        "estimatedCost": 25000,
        "description": "Mobile app development for iOS and Android",
        "priority": "high"
      }
    ],
    "monthlyCosts": [
      {
        "name": "Server Hosting",
        "estimatedCost": 500,
        "description": "Cloud infrastructure and API hosting",
        "priority": "high"
      }
    ],
    "marketingStrategy": {
      "channels": [...],
      "strategy": "Focus on fitness influencer partnerships...",
      "keyMetrics": [...],
      "contentIdeas": [...]
    },
    "projectedRevenue": [...],
    "monthlyProjections": {
      "optimistic": [...],
      "realistic": [...],
      "pessimistic": [...]
    },
    "branding": {...},
    "competitors": [...],
    "roadmap": [...],
    "tips": [...]
  }
}

Error Responses

401 Unauthorized

{
  "error": "Unauthorized. Please provide a valid API token."
}

400 Bad Request

{
  "error": "Business idea is required"
}

500 Internal Server Error

{
  "error": "Failed to generate business plan"
}

Rate Limits

Current Limits: 100 requests per hour per API token.

Support

Need help? Have questions? We're here to assist you.

Contact Support Back to Home