Live 43 humans online 5 active servers Peak online today 54 Record 102

Using SOF2MP.com Data (Free JSON API)

The free JSON API for live servers, players, matches and player counts, and how to credit SOF2MP.COM.

Updated 1 min read 📰 News and community

The numbers on SOF2MP.com are free to use. Please credit “SOF2MP.COM” with a link. For live use, there is a JSON API at /wp-json/sof2/v1/ with the live totals, every server, one server, one player, recent matches, population history and the last 24 hours. No key is needed.

Endpoints

Address Returns
/wp-json/sof2/v1/live Live totals: real players, bots and servers online.
/wp-json/sof2/v1/servers Every tracked server with its current state.
/wp-json/sof2/v1/server/{address} One server, by address and port.
/wp-json/sof2/v1/player/{name} One player.
/wp-json/sof2/v1/matches?limit=20&server= Recent matches, up to 100, optionally for one server.
/wp-json/sof2/v1/population?days=30 Population history, by day (days) or hour (hours), optionally for one server (server).
/wp-json/sof2/v1/replay The last 24 hours across servers, as used by the replay animation.

Fair use

  • The data only changes after each check of the servers, every 2 minutes, so there’s no point asking more often.
  • Credit “SOF2MP.COM” with a link wherever you show the numbers.
  • Player data is public game data about in-game names. Respect players who have deleted their stats; they won’t be in the API.

For how the numbers are made and their limits, see How we count. For a ready-made display, see Banners and widgets.

Was this article helpful?