Skip to content

UNIT3D API Response

Endpoint

GET {baseUrl}/api/user?api_token={TOKEN}

Most UNIT3D sites use /api/user by default. Override via the tracker's apiPath field if needed.

Authentication

Pass API token as a query parameter: ?api_token=TOKEN. No special headers required.

Example Response

{
  "username": "JohnDoe",
  "group": "Power User",
  "uploaded": "500.25 GiB",
  "downloaded": "125.50 GiB",
  "ratio": "3.99",
  "buffer": "374.75 GiB",
  "seeding": 156,
  "leeching": 2,
  "seedbonus": "12500.00",
  "hit_and_runs": 0
}

Byte values return as formatted strings ("500.25 GiB"), not integers. Same for ratio, buffer, and seedbonus — all strings. The adapter parses via parseBytes() or parseFloat().

Field Mapping

TrackerStats field UNIT3D field Type Notes
username username string Direct copy
group group string User class / rank label
uploadedBytes uploaded string Parsed via parseBytes()bigint
downloadedBytes downloaded string Parsed via parseBytes()bigint
ratio ratio string parseFloat(), defaults to 0
bufferBytes buffer string Parsed via parseBytes()bigint
seedingCount seeding number Direct copy
leechingCount leeching number Direct copy
seedbonus seedbonus string parseFloat(), defaults to 0
hitAndRuns hit_and_runs number Direct copy
requiredRatio Always null — not in UNIT3D API
warned Always null — not in UNIT3D API
freeleechTokens Always null — not in UNIT3D API

One API call per poll, no enrichment step.

Supported Trackers