API Reference v1

Deploy 100,000 AI Workers With One API Call

LVL3.AI is programmable infrastructure for AI workers. Spin up dedicated compute environments, execute tasks in parallel, and stream results back. All through a clean REST API.

100,000
Workers per batch
1:1
Compute ratio
15×
Parallel tasks
python
import lvl3

job = lvl3.workers.deploy(
    task="Analyze competitor pricing across 10,000 URLs",
    worker_type="web_browser",
    count=10_000,
    api_key="lvl3_sk_..."
)

# Stream 10,000 results in real time
results = job.wait()
print(f"{len(results.data)} records extracted")
API Overview

Simple, Predictable, Scalable

A REST API you can learn in an afternoon and scale to production without limits.

Authentication

All requests require a Bearer token in the Authorization header.

Authorization:Bearerlvl3_sk_...
Base URL

All requests target this base URL. Versioning ensures backward compatibility.

https://api.lvl3.ai/v1v1 stable
Rate Limits
Free100 workers / day
Pro10,000 workers / day
EnterpriseUnlimited
Response Format
{
"success": true,
"data": { ... },
"meta": {
"request_id": "req_abc123"
}
}
Quick Start

From zero to deployed in 3 steps

Get your first workers running in under 5 minutes.

01

Get your API Key

Sign in to your LVL3.AI dashboard and navigate to Settings → API Keys. Create a new key and copy it.

bash
# Your API key looks like this:
lvl3_sk_a1b2c3d4e5f6g7h8i9j0...
02

Install the SDK

Install the official SDK for your language, or use the REST API directly with any HTTP client.

bash
# Python
pip install lvl3

# JavaScript / Node.js
npm install @lvl3/sdk
03

Deploy your first worker

Deploy a worker and wait for results. It really is this simple.

python
import lvl3

client = lvl3.Client(api_key="lvl3_sk_...")

job = client.workers.deploy(
    task="Visit https://example.com and extract all product names and prices",
    worker_type="web_browser",
    count=1
)

result = job.wait()
print(result.data)
# → [{"name": "Product A", "price": 29.99}, ...]
Core Endpoints

Everything you need to orchestrate workers

Click any endpoint to expand the full request and response schema.

Code Examples

Real examples for real use cases

Copy-paste ready examples in Python, JavaScript, and cURL.

python
import lvl3

client = lvl3.Client(api_key="lvl3_sk_...")

# Deploy 50 web browser workers
job = client.workers.deploy(
    task="Extract product listings from competitor sites",
    worker_type="web_browser",
    count=50,
    config={
        "url": "https://example.com/products",
        "output_format": "json",
    }
)

print(f"Job started: {job.job_id}")

# Poll until complete
result = job.wait()
print(f"Extracted {len(result.data)} records")
SDKs & Integrations

Plug into your existing stack

Official SDKs and no-code integrations so every team can use LVL3.AI.

Python SDKOfficial

Async-first Python SDK with streaming support.

pip install lvl3
JavaScript SDKOfficial

TypeScript-native SDK for Node.js and the browser.

npm install @lvl3/sdk
REST APIAlways available

Use any HTTP client. No SDK required.

https://api.lvl3.ai/v1
ZapierIntegration

Connect LVL3.AI to 5,000+ apps without code.

Available on Zapier Marketplace
Make (Integromat)Integration

Visual automation with LVL3.AI as a trigger or action.

Available on Make Marketplace
n8nIntegration

Self-hosted workflow automation with full LVL3.AI support.

npm install n8n-nodes-lvl3
Webhooks

Event-driven results delivery

Register a webhook URL and LVL3.AI will push results to you the moment workers complete. No polling required.

Webhook Payload

json
{
  "event": "job.completed",
  "job_id": "job_9f2a1c3e",
  "timestamp": "2024-01-15T10:35:00Z",
  "data": {
    "total_workers": 50,
    "completed": 49,
    "failed": 1,
    "results_url": "https://api.lvl3.ai/v1/results/job_9f2a1c3e"
  }
}

Verify Signature

typescript
// Verify webhook signature (Node.js)
import crypto from "crypto";

function verifyWebhook(payload: string, sig: string, secret: string) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(payload)
    .digest("hex");

  return crypto.timingSafeEqual(
    Buffer.from(sig),
    Buffer.from(expected)
  );
}

Available Events

job.completedjob.failedjob.cancelledworker.errorbatch.completed
Error Reference

Errors that make sense

Every error includes a code, message, and what to do next.

CodeErrorDescription
401UnauthorizedInvalid or missing API key.
403ForbiddenAPI key lacks permission for this action.
422Unprocessable EntityRequest body validation failed. Check required fields.
429Rate LimitedToo many requests. Retry after the Retry-After header value.
503Worker CapacityRequested worker count exceeds your plan limit.
500Internal ErrorSomething went wrong on our end. Contact support.

Ready to deploy at scale?

Get your API key and start deploying AI workers today. Free tier included, no credit card required.