How do I list my idle game on IdleServList?

Paste the official site at https://idleservlist.com/en/sugerir (or POST to /api/submit). The bot confirms it's an online idle game and publishes it within minutes.

How do I show my game's online players?

Expose GET /api/status returning JSON like {"online": 123}. OT servers are read straight from the status protocol.

Can I pay to rank higher?

No. The Score is calculated only from real data: community, activity, stability, votes and maturity.

How to rank your idle game

IdleServList is 100% automatic: nobody pays to rank higher. Your game climbs when the real numbers climb. This guide shows exactly what the bot measures — and what to do to rank well.

1. Get listed

Paste the official site on Suggest a game. The bot visits the page, confirms with AI that it's an online idle game, writes the description and publishes it — usually within minutes. Requirements:

Your own domain (sites on *.vercel.app, *.github.io, *.pages.dev etc. are not accepted).
The game's official site online, with a <title>, meta description and an og:image (ideally 1260×500).
It must be an idle game (apps, multi-account browsers and tools are not listed).

2. Understand the Score (0 to 10)

Fixed scale, the same for every game, recalculated every hour:

Community · Discord members. Invite link visible on the site and server widget enabled.

30%

Activity now · Connected players (via /api/status or the OT protocol) and people online on Discord.

30%

Stability · Uptime over the last 7 days: the site must respond fast and without errors.

20%

Votes · Player votes this month. Share the badge and the vote link with your community.

10%

Other information · Game released (not just beta/coming soon), player record, domain age and other popularity signals. It only adds: new games never lose points.

3. Show your online players

It's what makes your game stand out the most. Expose a public endpoint (no login) with the current count:

GET https://yourgame.com/api/status
{"online": 123}

We also accept players_online, playersOnline or online_players, and paths like /api/online or /status.json. OT servers (Tibia/PokeTibia) are read straight from the status protocol — just show the server IP:port on your site or on otservlist.

Numbers are checked automatically: variation through the day, share of total accounts and comparison with Discord. The ranking uses the 7-day median, so spikes don't help. Inconsistent counts show as unverified and don't count until reviewed. Send the real number and everybody wins.

4. Discord community

Put the invite link (discord.gg/…) on your home page — preferably an invite that never expires.
Enable the server widget (Server Settings → Widget). That way we show who's online even if the invite changes.

5. Stability and votes

The bot visits your home page every ~10 minutes. Aggressive anti-bot protection (Cloudflare "Under Attack") can make the game look offline — prefer normal mode.
Ask your community for votes and add the status badge to your site (it's on your game page, under "Are you the owner?").

Building a game with AI (ChatGPT, Claude…)?

Ask the AI to read https://idleservlist.com/llms.txt. Everything is there: how to list the game via POST /api/submit, the /api/status format and best practices to start with a high score.

curl -X POST https://idleservlist.com/api/submit -H "Content-Type: application/json" -d '{"url": "https://yourgame.com"}'