API Reference

Complete API documentation for integrating AUM into your applications.

Authentication

All API requests require a Bearer token:

curl -X POST https://api.aumdatalabs.com/api/data/upload \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@data.csv"

Getting Your API Token

1. Go to Settings → API Keys
2. Click "Generate New Key"
3. Store securely (shown only once)

Endpoints

Upload Dataset

POST /api/data/upload
Content-Type: multipart/form-data

Parameters:
- file: CSV or Excel file (max 50MB)
- user_email: string
- subscription_type: "free" | "professional" | "enterprise"

Response:
{
  "domain": "ecommerce",
  "confidence": 0.87,
  "insights": [...],
  "data_preview": {...}
}

Execute Query

POST /api/query/execute
Content-Type: application/json

Body:
{
  "file": <file_blob>,
  "prompt": "top 10 products by revenue",
  "columns": ["product", "revenue"]
}

Response:
{
  "success": true,
  "result": {
    "columns": ["product", "revenue"],
    "data": [...]
  }
}

Smart Join

POST /api/joins/join-suggestions
Content-Type: multipart/form-data

Parameters:
- files: Array of files

Response:
{
  "suggestions": [
    {
      "left": "orders.csv",
      "right": "customers.csv",
      "left_on": "customer_id",
      "right_on": "id",
      "confidence": 0.92
    }
  ]
}

Rate Limits

• Free: 100 requests/hour
• Professional: 1,000 requests/hour
• Enterprise: 10,000 requests/hour

SDKs

JavaScript/TypeScript

npm install @aum-datalabs/sdk

import AUM from '@aum-datalabs/sdk';

const client = new AUM({ apiKey: 'YOUR_KEY' });

const analysis = await client.upload('data.csv');
console.log(analysis.domain); // "ecommerce"

Python

pip install aum-datalabs

from aum import AUMClient

client = AUMClient(api_key='YOUR_KEY')
analysis = client.upload('data.csv')
print(analysis.domain)  # "ecommerce"

Complete reference: https://docs.aumdatalabs.com/api