Free regional data API

LobbyKD API

Retrieve the latest aggregate K/D World Map figures in JSON. No API key is required for the free allowance.

Live regional aggregates No API key 10 requests daily

Current combined sample23,416lobbies across three regions

GET · API v1

World map endpoint

Available

Send a GET request to the versioned world-map endpoint. It returns every supported region by default, or one region when the optional region query parameter is supplied.

GEThttps://lobbykd.com/api/v1/world-map

All regionsNo query parameter United States?region=usa Europe?region=europe Rest of world?region=rest_of_world

Response fields

Available data

Each region includes a stable region code, display name, current average lobby K/D and the number of lobbies in that regional sample. The response also includes the combined sample size and last aggregate update time.

regionStable region identifier

nameHuman-readable region name

average_lobby_kdCurrent regional average K/D

lobbies_checkedRegional sample size

total_lobbies_checkedCombined returned sample

updated_atLatest aggregate update in UTC

Fair use

Free usage limit

The free endpoint allows 10 requests per UTC calendar day for each public IP address. No API key or LobbyKD account is required. Rate-limit headers show the allowance, remaining requests and reset time.

To enforce the allowance, the API usage table stores a keyed hash of the public IP with the daily count for up to 45 days; it does not store the raw IP address. Sites behind a reverse proxy or CDN should configure trusted-proxy handling so the correct client IP is used.

10requests

24hUTC window

X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset

Quick start

How to call the API

Use a normal HTTPS GET request from a server, script, website or command-line tool. Cross-origin GET requests are allowed.

cURL

curl "https://lobbykd.com/api/v1/world-map"

JavaScript

const response = await fetch('https://lobbykd.com/api/v1/world-map');
const payload = await response.json();
console.log(payload.data.regions);

PHP

$json = file_get_contents('https://lobbykd.com/api/v1/world-map');
$data = json_decode($json, true);
print_r($data['data']['regions']);

Example JSON

Current response structure

Live values shown

{
    "ok": true,
    "data": {
        "api_version": "v1",
        "regions": [
            {
                "region": "europe",
                "name": "Europe",
                "average_lobby_kd": 1.17,
                "lobbies_checked": 10275
            },
            {
                "region": "rest_of_world",
                "name": "Rest of the world",
                "average_lobby_kd": 1.09,
                "lobbies_checked": 328
            },
            {
                "region": "usa",
                "name": "United States",
                "average_lobby_kd": 1.11,
                "lobbies_checked": 12813
            }
        ],
        "total_lobbies_checked": 23416,
        "updated_at": "2026-08-04T16:04:38+00:00",
        "methodology_url": "https://lobbykd.com/lobbykd-api#methodology"
    },
    "rate_limit": {
        "limit": 10,
        "remaining": 9,
        "reset_at": "2026-08-05T00:00:00+00:00"
    }
}

Aggregate methodology

How the regional figures are calculated

Each eligible account can contribute a specific lobby ID once to its selected region. Repeat checks from the same account do not increase the sample. Every counted lobby contributes one equally weighted K/D observation.

The API serves cumulative weighted regional averages, so larger samples naturally move less when a new lobby is added.

The API provides aggregate analytical estimates only. It does not expose individual accounts, private lobby histories or official Activision data.