TETR.IO

About TETR.IO

TETR.IO's TETRA CHANNEL REST API provides read access to player and system data for the TETR.IO game, available at https://ch.tetr.io/api/. It is distinct from the main game API, which requires explicit written consent to use. No account or bot account is required to use the TETRA CHANNEL API, though requests are logged.

The API exposes endpoints covering server statistics and activity, user information and summaries (including per-gamemode summaries for 40 Lines, Blitz, Quick Play, Expert Quick Play, Tetra League, and Zen), user search and leaderboards (current and historical), user personal records, game records and record search, news, "Labs" data (scoreflow, leagueflow, league ranks), and achievements with their leaderboards. Server statistics include figures such as user counts, accounts created per second, games played, game time, inputs, and pieces placed. User info includes fields like username, role, badges, XP, games played/won, game time, country, supporter status, and avatar/banner references.

The API is intended for developers building tools or integrations around TETR.IO player and server data. Usage guidelines request a moderate request rate (around once per second), honoring cache expiration times, and use of an X-Session-ID header for repeated requests to the same datasets to maintain consistency and reduce database load. The API is described as subject to change with or without notice, and usage must comply with the TETR.IO Terms of Service.

Key features

• Read-only REST API for TETR.IO player and system data (TETRA CHANNEL API)
• User info, summaries, and personal records by game mode (40 LINES, BLITZ, QUICK PLAY, TETRA LEAGUE, ZEN)
• User search and leaderboards, including historical season leaderboards
• Server statistics and 2-day user activity graphs
• Game records lookup and reverse record search
• News feed, achievements, and labs data (scoreflow, leagueflow, league ranks)

Frequently asked questions