Introduction

Loadlab is a modern load testing platform designed for API-first teams. Test, analyze, and improve your API performance before issues hit production.

Tip: Start with a simple scenario of 10 VUs for 60 seconds to get familiar with the platform.

Quickstart

Get your first load test running in under 5 minutes.

Create a project

Projects group your scenarios, endpoints, and environments together.

Add endpoints

Define the API endpoints you want to test, either manually or by importing an OpenAPI spec.

Create a scenario

Configure virtual users, duration, and which endpoints to include.

Run your test

Launch the test and watch live metrics as virtual users hit your API.

Projects

Projects are the top-level container for organizing your load tests.

Group related scenarios together
Manage endpoints and environments
Track performance history over time

Scenarios

A scenario defines how your load test will run: number of virtual users, duration, and which endpoints to target.

Example scenario configuration

{
  "name": "Homepage load test",
  "vus": 100,
  "durationSeconds": 300,
  "mode": "DURATION",
  "endpoints": [
    { "endpointId": "...", "weight": 3 },
    { "endpointId": "...", "weight": 1 }
  ]
}

Endpoints

Endpoints are the API routes you want to test. Each endpoint has a method (GET, POST, etc.) and a path.

Manual definition

Add endpoints one by one with method and path.

OpenAPI import

Import endpoints from an OpenAPI/Swagger specification.

Environments

Environments define the target URL and default headers for your tests. Use them to test against staging, production, or local instances.

Security: Loadlab blocks requests to localhost, private IPs, and cloud metadata endpoints to prevent SSRF attacks.

Test Runs

A run is a single execution of a scenario. Each run produces metrics and endpoint stats.

PENDINGRUNNINGCOMPLETEDFAILEDCANCELLED

Metrics

Loadlab collects detailed performance metrics during each test run.

P95 / P99 Latency

Response time at the 95th and 99th percentile

Throughput (RPS)

Number of requests processed per second

Error Rate

Percentage of failed requests (4xx/5xx)

Virtual Users

Number of concurrent virtual users active

CI/CD Integration

Integrate LoadLab into your CI/CD pipeline to catch performance regressions before they reach production.

View full documentation