About CS2ServerList

Overview Ranking System Features Plugin Integration Discord Integration FAQ

Frequently Asked Questions

How do I ensure my server can be scanned?

For our system to correctly scan your server and update its status, you need to ensure that our scanning IPs have access to your server through any firewalls or security measures you have in place.

Whitelist the following IP range:

85.190.242.112/29

This allows our systems to query your server using the A2S protocol to retrieve server information, player counts, and other necessary data.

Common Firewall Configuration Examples:

UFW (Ubuntu/Debian):

sudo ufw allow from 85.190.242.112/29 to any port 27015

iptables:

iptables -A INPUT -s 85.190.242.112/29 -p udp --dport 27015 -j ACCEPT

Windows Firewall: Add an inbound rule for UDP port 27015 (or your server port) allowing connections from the IP range 85.190.242.112/29

How can I use the CS2ServerList API?

Our public API allows you to access server and community data programmatically. All endpoints return JSON data and support CORS for web applications.

Server Endpoints:

Get Server Information:

GET /api/server/{ip:port}

Example: https://cs2serverlist.com/api/server/lupercalia.f5.si:27016

Get Server Players:

GET /api/server/{ip:port}/players

Example: https://cs2serverlist.com/api/server/lupercalia.f5.si:27016/players

Get Server Statistics:

GET /api/server/{ip:port}/stats

Returns player count trends and performance metrics

Get Server Map Statistics:

GET /api/server/{ip:port}/map-stats

Returns map rotation and popularity data

Get Top Players:

GET /api/server/{ip:port}/top-players

Returns leaderboard of top performing players

Community Endpoints:

Get Community by Slug:

GET /api/community/{slug}/slug

Example: https://cs2serverlist.com/api/community/utopiafps/slug

Include Community Servers:

GET /api/community/{slug}/slug?includeServers

Add includeServers parameter to get all servers in the community

Include Player Lists:

GET /api/community/{slug}/slug?includeServers&includePlayersList

Add includePlayersList to also get current players on each server

Get Community Statistics:

GET /api/community/{id}/stats

Returns community performance metrics and trends

API Notes:

All responses are in JSON format
No authentication required for public endpoints
CORS is enabled for web applications
Rate limiting may apply for high-volume usage
Use query parameters to customize response data

Why isn't my server appearing in search results?

There are several possible reasons:

Your firewall may be blocking our scanning IPs (see above)
Your server may be offline or unreachable
You may need to toggle the "Show on Main Page" setting in your server management dashboard
The server might be newly added and still being indexed