BrainPredict Commerce Custom Platform Integration

Custom Platform Integration Guide

Integrate BrainPredict Commerce with any custom e-commerce platform using our REST API.

Step 1: Authentication

All API requests require authentication using your API key:

curl -X GET https://api.brainpredict.ai/api/v1/health \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Step 2: Track User Behavior

Send user events to BrainPredict Commerce for personalization:

POST /api/v1/personalization/track
{
  "user_id": "user123",
  "event_type": "product_view",
  "product_id": "prod456",
  "timestamp": "2025-01-02T10:30:00Z",
  "metadata": {
    "category": "electronics",
    "price": 299.99
  }
}

Step 3: Get Recommendations

Retrieve personalized product recommendations:

POST /api/v1/personalization/recommendations
{
  "user_id": "user123",
  "context": "product_page",
  "current_product_id": "prod456",
  "limit": 10,
  "filters": {
    "category": "electronics",
    "price_range": [100, 500]
  }
}

Step 4: Generate Social Content

Create social media posts automatically:

POST /api/v1/social/generate-post
{
  "product_id": "prod456",
  "platform": "instagram",
  "style": "professional",
  "include_hashtags": true,
  "target_audience": "tech_enthusiasts"
}

Error Handling

Handle API errors gracefully:

try {
    response = requests.post(url, headers=headers, json=data)
    response.raise_for_status()
    return response.json()
except requests.exceptions.HTTPError as e:
    if e.response.status_code == 401:
        # Invalid API key
    elif e.response.status_code == 429:
        # Rate limit exceeded
    elif e.response.status_code == 500:
        # Server error