REST API · JSON over TLS · Scoped keys

REST API stresser — launch, stop and inspect tasks with one HTTP call.

Launch, stop and inspect IP stresser tasks with a single HTTP call. GET and POST supported, JSON over TLS. If you already have scripts or a CI pipeline, the API slots in without a fight.

Authentication

Every request carries a scoped key in the Authorization header. Keys can be issued, rotated and revoked from the panel at any time. Per-key task-time and slot caps are enforced server-side.

Request header

Authorization: Bearer <your-scoped-key>
Content-Type: application/json

Scoped keys. Issue, rotate and revoke per-key. Per-key task-time and slot caps keep a shared key inside its lane.

Atomic slots. Slot reservation is atomic, so two tasks cannot claim the same slot at the same instant.

Plan gate. Pro and Business include API access. Starter and the free tier do not.

Endpoints

Four core verbs: launch, stop, list, inspect. Every endpoint is JSON over TLS. Base URL: https://littleandking.com/api/v1

POST /api/v1/task

Launch a task. The target must already be DNS-verified. The job is accepted and queued; the panel and the inspect endpoint show live status.

Body

{
  "target": "api.example.com",
  "layer": "L7",
  "method": "https-flood",
  "duration": 300,
  "rate": 250000
}

Response 202

{
  "id": "LK-4102",
  "status": "queued"
}
POST /api/v1/task/{id}/stop

Stop a running or queued task. The task moves to stopped and the slot is released immediately.

Response 200

{
  "id": "LK-4102",
  "status": "stopped"
}
GET /api/v1/tasks

List tasks for the current key. Returns queued, running and recently finished tasks. Scoped to the key's account and slot cap.

Response 200

{
  "tasks": [
    { "id": "LK-4102", "status": "running", "elapsed": 204 },
    { "id": "LK-4098", "status": "finished" }
  ]
}
GET /api/v1/task/{id}

Inspect a single task. Returns status, elapsed time, remaining time and live throughput while the test runs.

Response 200

{
  "id": "LK-4102",
  "status": "running",
  "elapsed": 204,
  "remaining": 396,
  "throughput": "6.84M req/s"
}

Wire it into a pipeline

A typical CI hook: verify the staging domain once, launch a short test on deploy, inspect once a second, stop on failure. Four calls, no panel.

# 1. Launch
POST /api/v1/task
Authorization: Bearer $LK_KEY

# 2. Poll every second
GET /api/v1/task/LK-4102
Authorization: Bearer $LK_KEY

# 3. If success rate drops below threshold, stop
POST /api/v1/task/LK-4102/stop
Authorization: Bearer $LK_KEY

# 4. Read your own metrics and attach the result to the deploy log

DNS-verified. Every target has to pass a DNS TXT check before a test can start, and we re-check it right before each run.

Scoped keys per stage. Issue one key for staging and another for production, so a leaked staging key cannot touch production targets.

Read your own metrics. The API shows what was sent. Your CPU, memory and error rate show what happened on the target.

Key limits and plan gates

Plan API access Concurrent slots Max task runtime
FreeNo1120 s
StarterNo110 min
ProYes52 h
BusinessYes10024 h

Per-key caps are set when a key is issued and can be changed on rotation. Slot reservation is atomic, so two tasks on the same key cannot overshoot the plan's concurrent limit.

API FAQ

Does the IP stresser have an API?+

Yes. Every plan above Starter includes full REST API access. Launch, stop, list and inspect tasks with single HTTP calls (GET and POST), all JSON over TLS. Keys are scoped, rotatable and revocable.

Which plan includes API access?+

Pro and Business include full REST API access. Starter does not — the plan card marks API access as closed. The free stresser tier also does not include API access.

How are API keys scoped?+

Keys are scoped with per-key task-time and slot caps, plus atomic slot reservation. A shared key cannot quietly blow through the limits set for it. Keys can be issued, rotated and revoked whenever you want.

What format does the API use?+

JSON over TLS. Both GET and POST are supported. Launch, stop and inspect tasks with single HTTP calls, and wire the calls into your own scripts or CI pipeline without clicking through a panel.

Can I cancel my plan anytime?+

Yes. All paid plans are month-to-month with no long-term contracts. Upgrade, downgrade or cancel from the billing panel whenever you want — your remaining slot-time stays usable until the end of the paid period.

Wire the API into your pipeline.

Upgrade to Pro or Business, issue a scoped key, and launch your first test with a single HTTP call. Read your own metrics and attach the result to your deploy log.