Read-only access to the guild and player leaderboard data behind GuildLB, plus shared blacklists for alliance guilds.
Responses are JSON and come from GuildLB's cache, so they are fast but can be up to a few days old. Nothing here calls Hypixel on your behalf.
Every endpoint needs an API key. Send it in the x-api-key header, or as Authorization: Bearer YOUR_API_KEY. Keep it on your server; never ship it in a browser app or a public repository.
curl "https://guildlb.com/api/player/ExamplePlayer" \
-H "x-api-key: YOUR_API_KEY"Using a GuildLB API key means you agree to these terms.
Each key gets 120 requests per minute unless we agreed a different limit. Every response reports the window in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset.
Over the limit you get 429 RATE_LIMITED; wait for the Retry-After seconds before trying again. Cache what you fetch instead of polling: most of it changes over hours or days.
HTTP/1.1 200 OK
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 1792370645
HTTP/1.1 429 Too Many Requests
Retry-After: 12Every response has the same envelope: success, then data on success or error with a code and message on failure. Any endpoint can return:
401UNAUTHORIZED429RATE_LIMITEDRetry-After.503AUTH_UNAVAILABLE{
"success": true,
"data": {
"name": "ExamplePlayer"
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}Guild lookups.
/api/guild/{name}Cached guild data, up to a few days old.
namerequiredpath · string200404curl "https://guildlb.com/api/guild/Example%20Guild" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"id": "0123456789abcdef0123456789abcdef",
"name": "Example Guild",
"level": 120,
"skillavg": 52.4,
"slayers": 1850000,
"catacombs": 48.3,
"networth": 41200000000,
"networth_formatted": "41.20B",
"slayers_formatted": "1.85M",
"placement": 12,
"is_alliance": false,
"top_skill": null,
"top_rank": null,
"discord_link": "https://discord.gg/example",
"discordUrl": "https://discord.gg/example",
"iconUrl": "https://guildlb.com/api/guild/Example%20Guild/icon",
"bannerUrl": null,
"bannerPos": null,
"bio": "An example guild.",
"preferred_games": [],
"memberCount": 2,
"members": [
{
"uuid": "01234567-89ab-cdef-0123-456789abcdef",
"name": "ExamplePlayer",
"guild_id": "0123456789abcdef0123456789abcdef",
"guild_name": "Example Guild",
"guild_rank": "Guild Master",
"skyblock_level": 312,
"skills": 54.1,
"slayers": 950000,
"catacombs": 51.2,
"networth": 2300000000
}
]
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 900
}
}/api/guild/{name}/activityCached join and leave events from the last 90 days, newest first. Events are detected when the guild is refreshed, so a leave is timed to the refresh that noticed it.
namerequiredpath · stringlimitquery · integer · default 100 · max 500200curl "https://guildlb.com/api/guild/Example%20Guild/activity" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"events": [
{
"uuid": "01234567-89ab-cdef-0123-456789abcdef",
"username": "ExamplePlayer",
"type": "join",
"occurred_at": "2026-10-17T18:04:00.000Z"
}
]
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 900
}
}Player lookups.
/api/player/{name}Cached player totals, up to a few days old. Untracked players return 404.
namerequiredpath · string200400404curl "https://guildlb.com/api/player/ExamplePlayer" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"uuid": "01234567-89ab-cdef-0123-456789abcdef",
"name": "ExamplePlayer",
"guild_id": "0123456789abcdef0123456789abcdef",
"guild_name": "Example Guild",
"guild_rank": "Guild Master",
"skyblock_level": 312,
"skills": 54.1,
"slayers": 950000,
"catacombs": 51.2,
"networth": 2300000000,
"non_cosmetic_networth": 2100000000,
"networth_formatted": "2.30B",
"slayers_formatted": "950.00K",
"updated_at": "2026-10-05T11:30:00Z"
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 900
}
}Guild event standings.
/api/eventsEvents the named guild takes part in. Guild names match case-insensitively. Cached for a minute. Website keys need the events scope. Alliance guild keys are also accepted and only see their own guild.
guildrequiredquery · string200400curl "https://guildlb.com/api/events" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": [
{
"id": "evt_123",
"name": "Example Showdown",
"mode": "networth",
"status": "active",
"startAt": "2026-10-01T00:00:00Z",
"endAt": "2026-11-01T00:00:00Z",
"guildA": {
"id": "0123456789abcdef0123456789abcdef",
"name": "Example Guild"
},
"guildB": {
"id": "fedcba9876543210fedcba9876543210",
"name": "Other Guild"
}
}
],
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 60
}
}/api/events/{id}Live standings for one event: guild points and per-member points. Cached for a minute. Website keys need the events scope. Alliance guild keys are also accepted and only see their own guild.
idrequiredpath · string200404curl "https://guildlb.com/api/events/example" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"event": {
"id": "evt_123",
"name": "Example Showdown",
"guildA": "0123456789abcdef0123456789abcdef",
"guildB": "fedcba9876543210fedcba9876543210",
"startAt": "2026-10-01T00:00:00Z",
"endAt": "2026-11-01T00:00:00Z",
"mode": "networth",
"status": "active"
},
"guilds": [
{
"id": "0123456789abcdef0123456789abcdef",
"name": "Example Guild",
"points": 1200,
"updatedAt": "2026-10-30T00:00:00Z"
}
],
"members": [],
"asOf": "2026-10-30T00:00:00Z"
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 60
}
}Player networth.
/api/player/{name}/networthCached total and non-cosmetic networth, up to a few days old. Untracked players return 404.
namerequiredpath · string200400404curl "https://guildlb.com/api/player/ExamplePlayer/networth" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"total": 2300000000,
"nonCosmetic": 2100000000,
"updatedAt": "2026-10-05T11:30:00Z",
"breakdown": null
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 900
}
}Cached SkyBlock item prices.
/api/pricesBatch prices from GuildLB's cached bazaar and auction data, up to 100 ids per request. Bazaar items return buy and sell; auction items return the lowest BIN and a recent median. Ids without data return source null and a reason.
idsrequiredquery · string200400503curl "https://guildlb.com/api/prices" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"prices": {
"ENCHANTED_DIAMOND": {
"source": "bazaar",
"buy": 1620.4,
"sell": 1498.2,
"updatedAt": "2026-10-05T11:59:00Z"
},
"HYPERION": {
"source": "auction",
"lowestBin": 905000000,
"median": 931000000,
"updatedAt": "2026-10-05T11:58:00Z"
},
"NOT_AN_ITEM": {
"source": null,
"reason": "no_price_data"
}
}
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z",
"ttl": 60
}
}Details about the key you call with.
/api/keyName, type, rate limit and request counts for the key on this request. Never describes any other key. Counts as a normal request.
200curl "https://guildlb.com/api/key" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"type": "website",
"name": "My bot",
"createdAt": "2026-09-01T10:00:00.000Z",
"expiresAt": null,
"rateLimit": {
"max": 120,
"windowSeconds": 60,
"used": 3,
"remaining": 117,
"resetsAt": "2026-10-05T12:01:00.000Z"
},
"usage": {
"today": 42,
"last7Days": 310,
"rateLimitedLast7Days": 0
}
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}Shared blacklists for alliance guilds.
/api/alliance/blacklist/check/{player}Shared alliance entries plus your guild's private ones. Accepts a username or UUID.
playerrequiredpath · string200curl "https://guildlb.com/api/alliance/blacklist/check/ExamplePlayer" \
-H "x-api-key: YOUR_GUILD_KEY"{
"success": true,
"data": {
"blacklisted": true,
"entries": [
{
"guildId": "0123456789abcdef0123456789abcdef",
"guildName": "Example Guild",
"category": "SCAMMING",
"reason": "Chargeback scam",
"addedBy": "123456789012345678",
"public": true,
"createdAt": "2026-08-08T12:00:00Z"
}
]
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}/api/alliance/scammer/{player}SkyBlockZ plus shared alliance scamming entries. Accepts a username or UUID. Can take a few seconds.
playerrequiredpath · string200400404502curl "https://guildlb.com/api/alliance/scammer/ExamplePlayer" \
-H "x-api-key: YOUR_GUILD_KEY"{
"success": true,
"data": {
"uuid": "0123456789abcdef0123456789abcdef",
"name": "ExamplePlayer",
"scammer": true,
"skyblockz_status": "flagged",
"flags": [
{
"source": "SkyBlockZ",
"reason": "Coop scam"
},
{
"source": "Guild Alliance",
"reason": "Chargeback scam"
}
]
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}/api/guild/blacklistYour guild's own blacklist.
200curl "https://guildlb.com/api/guild/blacklist" \
-H "x-api-key: YOUR_GUILD_KEY"{
"success": true,
"data": [
{
"playerUuid": "0123456789abcdef0123456789abcdef",
"category": "SCAMMING",
"reason": "Chargeback scam",
"addedBy": "123456789012345678",
"public": true,
"createdAt": "2026-08-08T12:00:00Z"
}
],
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}/api/guild/blacklistAdds a player by UUID. Returns 409 if they are already listed; remove them first to change the entry.
playerUuidrequiredstringcategorySCAMMING | CHEATING | TOXICITY | ALT_ABUSE | OTHERreasonstringaddedByrequiredstringpublicboolean200400403409curl -X POST "https://guildlb.com/api/guild/blacklist" \
-H "x-api-key: YOUR_GUILD_KEY" \
-H "Content-Type: application/json" \
-d '{"playerUuid":"0123456789abcdef0123456789abcdef","category":"SCAMMING","reason":"Chargeback scam","addedBy":"123456789012345678","public":true}'{
"success": true,
"data": {
"id": 42,
"playerUuid": "0123456789abcdef0123456789abcdef",
"category": "SCAMMING",
"public": true
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}/api/guild/blacklist/{player}Removes a player by UUID.
playerrequiredpath · string200404curl -X DELETE "https://guildlb.com/api/guild/blacklist/0123456789abcdef0123456789abcdef" \
-H "x-api-key: YOUR_GUILD_KEY"{
"success": true,
"data": {
"removed": true
},
"meta": {
"generatedAt": "2026-10-05T12:00:00.000Z"
}
}Website keys are issued by hand. Tell us what you are building and we will reach out.