Overview

VantaHub is a REST API that bundles six developer tools behind a single key: random data generation, website analysis, screenshots, QR codes and JSON processing. Every response is typed JSON, every request is authenticated with a bearer token.

Base URL for all requests:

https://api.vantahub.ct8.pl

Quickstart

Get a UUID with a single request:

const res = await fetch("https://api.vantahub.ct8.pl/random/uuid", {
  headers: { Authorization: "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx" }
});

const { data } = await res.json();
console.log(data.value); // "3f2a1b4c-...";

curl https://api.vantahub.ct8.pl/random/uuid \
  -H "Authorization: Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx"

import requests

res = requests.get(
    "https://api.vantahub.ct8.pl/random/uuid",
    headers={"Authorization": "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(res.json()["data"]["value"])

Authentication

All API requests require an API key sent as a bearer token in the Authorization header. Keys start with vh_live_ and are generated from the dashboard.

fetch("https://api.vantahub.ct8.pl/random", {
    headers: {
        Authorization: "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx"
    }
})

Invalid or missing keys return 401 with a structured error body. Keys are plaintext and shown in full only once — regenerate them from the dashboard if they leak.

Random API

Generate cryptographically-secure random data. The family of GET /random/* endpoints accepts query parameters and returns a single typed value.

Website Analyzer

Analyzes a public URL and returns status, latency, headers, SSL details, metadata and detected technologies. Results are cached for 10 minutes.

fetch("https://api.vantahub.ct8.pl/analyzer", {
  method: "POST",
  headers: {
    Authorization: "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com" }),
});

Minecraft

Two endpoints for the Minecraft ecosystem: live server status over the native ping protocol and player profiles resolved through Mojang's session API.

// Server status
fetch("https://api.vantahub.ct8.pl/minecraft/status", {
  method: "POST",
  headers: {
    Authorization: "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ host: "play.cubecraft.net", port: 25565 }),
});

// Player lookup
fetch("https://api.vantahub.ct8.pl/minecraft/player", {
  method: "POST",
  headers: {
    Authorization: "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ player: "Notch" }),
});

Screenshot API

Captures a public website and returns a PNG data-URL. Control viewport size and whether the full page is captured.

QR Generator

Generates QR codes from URLs, plain text or Wi-Fi credentials and returns them as a downloadable SVG.

JSON Formatter

Validates and normalizes JSON payloads server-side. Returns the formatted or minified document plus a validation report.

Errors

Errors always return a consistent JSON envelope with an HTTP status code, a machine-readable code and a human message.

{
  "ok": false,
  "error": {
    "message": "Invalid API key.",
    "code": "unauthorized",
    "status": 401
  }
}

Examples

Random color, client-side:

const { data } = await fetch("https://api.vantahub.ct8.pl/random/color?format=hex", {
  headers: { Authorization: "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx" },
}).then((r) => r.json());

document.body.style.background = data.value; // "#5865F2"

curl "https://api.vantahub.ct8.pl/random/color?format=hex" \
  -H "Authorization: Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx"

import requests

r = requests.get(
    "https://api.vantahub.ct8.pl/random/color?format=hex",
    headers={"Authorization": "Bearer vh_live_xxxxxxxxxxxxxxxxxxxxxxxxx"},
)
color = r.json()["data"]["value"]
print(color)  # "#5865F2"

Responses

Successful responses use a stable envelope. Always read data for the payload.

{
  "ok": true,
  "data": {
    "kind": "uuid",
    "value": "3f2a1b4c-8e7d-4b5a-9c0f-1d2e3a4b5c6d"
  },
  "meta": {
    "latency_ms": 12,
    "cache": "miss",
    "ts": "2026-08-05T12:00:00Z"
  }
}

Cached responses (like the analyzer's 10-minute TTL) include a cache field of hit and may carry ETag / Cache-Control headers for client-side reuse.

Rate limits

Limits are per-plan and reset monthly. Exceeding them returns 429 with a Retry-After header.

Questions? Head to the dashboard or grab a key and start building.