TETR.IO API

Beginner's Pick Games & Comics / No Auth Required Beginner HTTPS

Free to Use

92 A+

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

The TETR.IO API (Tetra Channel) provides real-time statistics and profile data for players of TETR.IO, a modern competitive Tetris game. It is free to use without authentication and returns data including rankings, scores, and replay information. Great for beginners interested in game data and leaderboards.

Beginner Tip

Usernames in TETR.IO are case-insensitive but must be URL-encoded if they contain special characters. Start by fetching a user profile to understand the data structure before querying leaderboards.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

Use case: Integrate tetr.io tetra channel api data into web and mobile applications

TETR.IO data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "id": 1,
  "name": "TETR.IO",
  "data": "TETR.IO Tetra Channel API",
  "source": "TETR.IO"
}

Field Reference

success Whether the API request was successful. Always check this before reading data.

data.user.username The unique display name of the TETR.IO player.

data.user.xp Total experience points earned by the player.

data.user.gamesplayed Total number of online games the player has participated in.

data.user.league.rating TETRA LEAGUE rating (TR) representing the player's competitive rank.

data.user.country Two-letter ISO country code of the player's registered country.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://ch.tetr.io/api/users/tetrio";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

404 Not Found The username does not exist or was typed incorrectly.

✓ Double-check the exact TETR.IO username; the API is case-insensitive but the user must exist.

Rate limited (429) Too many requests sent in a short time.

✓ TETR.IO enforces rate limits; add a delay of at least 1 second between requests and cache responses locally.

success: false in response The API returned an error object instead of data.

✓ Check the "error" field in the response JSON for a descriptive message explaining what went wrong.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →