Access and pricing
The API is paid, and there is no price list. Tell us what you are building, which endpoints you need and roughly how many requests you expect a month, and we will reply with a quote.
Email [email protected], message @csxp_gg on Twitter, or message snek239 on Discord.
Keys are issued by hand. Each one has a requests-per-minute limit, the endpoint groups it may call, and a monthly quota and an expiry date where those were agreed.
The API covers the same accounts as the site. Coverage is incomplete and a profile can be weeks out of date; the FAQ explains how often data is refreshed, and every response says when its data was last updated.
One endpoint needs no key: GET /api/{steamid64} returns a player's current leaderboard ranks and XP Overload streak.
Quick start
Send the key in the Authorization header. Every endpoint is a GET under https://csxp.gg/api/v1.
export CSXP_API_KEY="csxp_…"
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players/76561197960287930"
The response is a JSON object with the result in data and paging and freshness details in meta. Your key shows what a key may call and how much of its quota is left.
Authentication
Every request under /api/v1 needs a key, sent as Authorization: Bearer <key>. The X-API-Key: <key> header works too. Keys are not accepted in the URL.
A key is a secret. Call the API from a server, not from a web page or an app that users can inspect; responses carry no CORS headers. If a key leaks, tell us at [email protected] or on Twitter or Discord and we will revoke it and issue another.
Rate limits and quotas
A key's per-minute allowance refills continuously. A key allowed 60 requests a minute can send 60 at once and then one a second. A request over the limit gets a 429 with Retry-After set to the seconds until the next one is allowed.
A key with a monthly quota is cut off when it reaches it and starts again on the first of the next month, UTC. Requests answered with a 429 or a 5xx status do not count toward the quota; every other response does, including a 400 or a 404.
Responses
Successful responses are {"data": …, "meta": {…}}. Lists page with limit and offset, with page, or with a cursor, as each endpoint describes.
- SteamID64s are strings. They are larger than the integers JavaScript can hold exactly.
- Times are Unix seconds in UTC. Dates are
YYYY-MM-DD in UTC. - A value we have not observed is
null, never a zero or an empty string. url fields link to the matching page on csxp.gg, and image addresses are absolute.- Responses are specific to a key and marked
Cache-Control: private, no-store.
Fields can be added to a response at any time, so ignore the ones you do not know. Removing or renaming a field will come with a new version path.
The example responses on this page are real ones with long lists cut to a few rows, so a total in meta can be larger than the rows shown. Player names and SteamID64s in them are placeholders.
Errors
A failed request returns {"error": {"code": …, "message": …}}. Branch on the code; the message is written for people and may change.
Key
Your key
GET/api/v1/key
The calling key's endpoint groups, rate limit and this month's usage. Every key can call it, and it counts as a request.
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/key"
Example response
{
"data": {
"created_at": 1793491200,
"expires_at": null,
"name": "Acme Analytics",
"prefix": "csxp_1a2b3c4d",
"quota": {
"monthly_requests": 500000,
"remaining": 371580,
"resets_at": 1796083200,
"used": 128420
},
"rate_limit": {
"requests_per_minute": 120
},
"scopes": [
"players",
"leaderboards",
"collectibles",
"site",
"search"
]
},
"meta": {}
}
Players
Player profiles, histories, batch lookups and comparisons. Needs the players endpoint group.Player profile
GET/api/v1/players/{steamid64}
A player's current level, XP, Commends, bans, 2026 service medal progress, XP Overload streak, leaderboard ranks and share of tracked accounts at or above their XP. steam or cs is null when that half has not been collected yet. For a player the site does not track, a key with the lookups group queues a lookup and the response is a 404 with code lookup_queued; retry after a few seconds.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players/76561197960287930"
Example response
{
"data": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"cs": {
"collectible_count": 35,
"commends": {
"friendly": 405,
"leader": 329,
"teaching": 333,
"total": 1067
},
"exact_xp": true,
"level": 29,
"level_xp": 2016,
"total_level": 1429,
"total_xp": 7147016,
"updated_at": 1792489959
},
"lookup_pending": false,
"name": "Kestrel",
"ranks": [
{
"board": "overall",
"rank": 1,
"title": "CS2 XP Leaderboard",
"url": "https://csxp.gg/total#player-76561197960287930"
},
{
"board": "purple_medals",
"rank": 1,
"title": "Purple Medal Leaderboard",
"url": "https://csxp.gg/medals/purple#player-76561197960287930"
},
{
"board": "blue_medals",
"rank": 307,
"title": "Blue Medal Leaderboard",
"url": "https://csxp.gg/medals/blue#player-76561197960287930"
}
],
"service_medal_2026": {
"next_tier": 1,
"next_tier_xp": 200000,
"tier": 0,
"xp": 142016
},
"steam": {
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"updated_at": 1790079997
},
"steamid64": "76561197960287930",
"top_percent": 0.000171,
"url": "https://csxp.gg/players/76561197960287930",
"xp_overload": {
"active_weeks": null,
"longest_weeks": 1,
"match_url": null,
"observed_at": null,
"source": "xp_estimate"
}
},
"meta": {
"tracked_accounts": 584626
}
}
Players in bulk
GET/api/v1/players
Summaries of up to 100 players in one request, in the order asked for. Players the site does not track are listed in meta.not_tracked.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players?ids=76561197960287930,76561197960435530"
Example response
{
"data": [
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 35,
"commends": {
"friendly": 405,
"leader": 329,
"teaching": 333,
"total": 1067
},
"cs_updated_at": 1769079159,
"level": 29,
"level_xp": 2016,
"name": "Kestrel",
"steam_updated_at": 1790079997,
"steamid64": "76561197960287930",
"total_level": 1429,
"total_xp": 7147016,
"url": "https://csxp.gg/players/76561197960287930",
"xp_overload": {
"active_weeks": null,
"longest_weeks": 1,
"match_url": null,
"observed_at": null,
"source": "xp_estimate"
}
},
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 27,
"commends": {
"friendly": 231,
"leader": 178,
"teaching": 163,
"total": 572
},
"cs_updated_at": 1769132289,
"level": 2,
"level_xp": 3921,
"name": "Marlow",
"steam_updated_at": 1790075012,
"steamid64": "76561197960435530",
"total_level": 1362,
"total_xp": 6813921,
"url": "https://csxp.gg/players/76561197960435530",
"xp_overload": null
}
],
"meta": {
"count": 2,
"not_tracked": []
}
}
Player XP history
GET/api/v1/players/{steamid64}/xp-history
Every recorded state of the player's level, XP and Commends, oldest first. Each row covers the period from observed_from to observed_until during which nothing changed. At most the newest 5,000 rows are returned; meta.truncated says when older ones were left out.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players/76561197960287930/xp-history"
Example response
{
"data": [
{
"collectible_count": 34,
"commends": {
"friendly": 400,
"leader": 324,
"teaching": 328,
"total": 1052
},
"exact_xp": true,
"level": 9,
"level_xp": 2326,
"observed_from": 1787747564,
"observed_until": 1787747564,
"total_level": 1409,
"total_xp": 7047326
},
{
"collectible_count": 34,
"commends": {
"friendly": 400,
"leader": 324,
"teaching": 328,
"total": 1052
},
"exact_xp": true,
"level": 9,
"level_xp": 4366,
"observed_from": 1787754283,
"observed_until": 1787754283,
"total_level": 1409,
"total_xp": 7049366
}
],
"meta": {
"count": 28,
"truncated": false
}
}
Player collectibles
GET/api/v1/players/{steamid64}/collectibles
The medals, coins, pins and trophies the player holds, each with its holder count, and every recorded change to that set.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players/76561197960287930/collectibles"
Example response
{
"data": {
"changes": [
{
"added": [
{
"category": "pickem_coin",
"holders": 28707,
"id": 5211,
"image_url": "https://csxp.gg/images/bud2025_coin_silver_small_png.png",
"name": "Budapest 2025 Silver Coin",
"section": "Budapest 2025",
"share_percent": 4.910319,
"slug": "bud2025_coin_silver",
"url": "https://csxp.gg/collectibles/bud2025_coin_silver"
}
],
"at": 1787763161,
"previous_at": 1787754283,
"removed": [
{
"category": "pickem_coin",
"holders": 3501,
"id": 5210,
"image_url": "https://csxp.gg/images/bud2025_coin_bronze_small_png.png",
"name": "Budapest 2025 Coin",
"section": "Budapest 2025",
"share_percent": 0.598844,
"slug": "bud2025_coin_bronze",
"url": "https://csxp.gg/collectibles/bud2025_coin_bronze"
}
]
},
{
"added": [
{
"category": "premier_medal",
"holders": 3348,
"id": 5150,
"image_url": "https://csxp.gg/images/premier_season_3_coin_25_small_png.png",
"name": "Premier Season Three Medal · 5,000–9,999 · 125+ wins",
"section": "Season 3 · 5,000–9,999",
"share_percent": 0.572674,
"slug": "premier_season_3_coin_25",
"url": "https://csxp.gg/collectibles/premier_season_3_coin_25"
}
],
"at": 1792489959,
"previous_at": 1790813381,
"removed": []
}
],
"collectibles": [
{
"category": "badge",
"holders": 421108,
"id": 874,
"image_url": "https://csxp.gg/images/5yearcoin_small_png.png",
"name": "5 Year Veteran Coin",
"section": null,
"share_percent": 72.030324,
"slug": "5-year-veteran-coin",
"url": "https://csxp.gg/collectibles/5-year-veteran-coin"
},
{
"category": "badge",
"holders": 155862,
"id": 969,
"image_url": "https://csxp.gg/images/10yearcoin_small_png.png",
"name": "10 Year Veteran Coin",
"section": null,
"share_percent": 26.660121,
"slug": "10-year-veteran-coin",
"url": "https://csxp.gg/collectibles/10-year-veteran-coin"
},
{
"category": "badge",
"holders": 341624,
"id": 970,
"image_url": "https://csxp.gg/images/prime_badge_small_png.png",
"name": "Loyalty Badge",
"section": null,
"share_percent": 58.434623,
"slug": "loyalty-badge",
"url": "https://csxp.gg/collectibles/loyalty-badge"
}
],
"steamid64": "76561197960287930",
"updated_at": 1792489959
},
"meta": {
"changes_truncated": false,
"count": 35,
"tracked_accounts": 584626
}
}
Player rank history
GET/api/v1/players/{steamid64}/rank-history
The player's rank on each leaderboard at every publication they were ranked in, as [recorded_at, rank] pairs, oldest first.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players/76561197960287930/rank-history?board=overall"
Example response
{
"data": [
{
"board": "overall",
"current_rank": 1,
"points": [
[
1787747328,
1
],
[
1787754272,
1
],
[
1787763154,
1
]
],
"title": "CS2 XP Leaderboard"
}
],
"meta": {
"truncated": false
}
}
Player Steam profile history
GET/api/v1/players/{steamid64}/profile-history
Every recorded Steam name, avatar and ban state of the player, oldest first.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/players/76561197960287930/profile-history"
Example response
{
"data": [
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"name": "Kestrel",
"observed_from": 1787746119,
"observed_until": 1790079997
}
],
"meta": {
"count": 1,
"truncated": false
}
}
Compare two players
GET/api/v1/compare/{a}/{b}
Both players' summaries and the collectibles they share or hold alone.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/compare/76561197960287930/76561197960435530"
Example response
{
"data": {
"collectibles": {
"only_first": [
{
"category": "operation_coin",
"holders": 10896,
"id": 1013,
"image_url": "https://csxp.gg/images/operation_bravo_bronze_small_png.png",
"name": "Operation Bravo Challenge Coin",
"section": "Operation Bravo",
"share_percent": 1.863756,
"slug": "operation_bravo_bronze",
"url": "https://csxp.gg/collectibles/operation_bravo_bronze"
},
{
"category": "operation_coin",
"holders": 14842,
"id": 1024,
"image_url": "https://csxp.gg/images/operation_phoenix_bronze_small_png.png",
"name": "Operation Phoenix Challenge Coin",
"section": "Operation Phoenix",
"share_percent": 2.538717,
"slug": "operation_phoenix_bronze",
"url": "https://csxp.gg/collectibles/operation_phoenix_bronze"
}
],
"only_second": [
{
"category": "operation_coin",
"holders": 3019,
"id": 1014,
"image_url": "https://csxp.gg/images/operation_bravo_silver_small_png.png",
"name": "Silver Operation Bravo Coin",
"section": "Operation Bravo",
"share_percent": 0.516399,
"slug": "operation_bravo_silver",
"url": "https://csxp.gg/collectibles/operation_bravo_silver"
},
{
"category": "operation_coin",
"holders": 4949,
"id": 1026,
"image_url": "https://csxp.gg/images/operation_phoenix_gold_small_png.png",
"name": "Gold Operation Phoenix Coin",
"section": "Operation Phoenix",
"share_percent": 0.846524,
"slug": "operation_phoenix_gold",
"url": "https://csxp.gg/collectibles/operation_phoenix_gold"
}
],
"shared": [
{
"category": "badge",
"holders": 421108,
"id": 874,
"image_url": "https://csxp.gg/images/5yearcoin_small_png.png",
"name": "5 Year Veteran Coin",
"section": null,
"share_percent": 72.030324,
"slug": "5-year-veteran-coin",
"url": "https://csxp.gg/collectibles/5-year-veteran-coin"
},
{
"category": "badge",
"holders": 155862,
"id": 969,
"image_url": "https://csxp.gg/images/10yearcoin_small_png.png",
"name": "10 Year Veteran Coin",
"section": null,
"share_percent": 26.660121,
"slug": "10-year-veteran-coin",
"url": "https://csxp.gg/collectibles/10-year-veteran-coin"
}
]
},
"players": [
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 35,
"commends": {
"friendly": 405,
"leader": 329,
"teaching": 333,
"total": 1067
},
"cs_updated_at": 1769079159,
"level": 29,
"level_xp": 2016,
"name": "Kestrel",
"steam_updated_at": 1790079997,
"steamid64": "76561197960287930",
"total_level": 1429,
"total_xp": 7147016,
"url": "https://csxp.gg/players/76561197960287930",
"xp_overload": {
"active_weeks": null,
"longest_weeks": 1,
"match_url": null,
"observed_at": null,
"source": "xp_estimate"
}
},
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 27,
"commends": {
"friendly": 231,
"leader": 178,
"teaching": 163,
"total": 572
},
"cs_updated_at": 1769132289,
"level": 2,
"level_xp": 3921,
"name": "Marlow",
"steam_updated_at": 1790075012,
"steamid64": "76561197960435530",
"total_level": 1362,
"total_xp": 6813921,
"url": "https://csxp.gg/players/76561197960435530",
"xp_overload": null
}
],
"url": "https://csxp.gg/compare/76561197960287930/76561197960435530"
},
"meta": {
"tracked_accounts": 584626
}
}
Leaderboards
Leaderboards and per-collectible rankings. Needs the leaderboards endpoint group.Leaderboards
GET/api/v1/leaderboards
Every leaderboard with its key, what it ranks by and how many players qualify for it.
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/leaderboards"
Example response
{
"data": [
{
"board": "overall",
"description": "Sorted by total XP level. Remaining XP breaks ties.",
"player_count": 584626,
"title": "CS2 XP Leaderboard",
"url": "https://csxp.gg/total",
"value_label": "Level"
},
{
"board": "commendations",
"description": "Sorted by total commends. Friendly, leader, and teacher counts break ties.",
"player_count": 573494,
"title": "Commends Leaderboard",
"url": "https://csxp.gg/commendations",
"value_label": "Total Commends"
}
],
"meta": {
"count": 30,
"max_entries": 1000
}
}
Leaderboard entries
GET/api/v1/leaderboards/{board}
The top 1,000 players of a leaderboard. rank orders by the board's value alone; site_rank is the place on csxp.gg, which lists accounts with a possible Counter-Strike ban after everyone else. rank_change is the places gained since about a day earlier (negative when lost).
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/leaderboards/overall?limit=2"
Example response
{
"data": [
{
"ban_note": null,
"new_entry": false,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 35,
"commends": {
"friendly": 405,
"leader": 329,
"teaching": 333,
"total": 1067
},
"cs_updated_at": 1769079159,
"level": 29,
"level_xp": 2016,
"name": "Kestrel",
"steam_updated_at": 1790079997,
"steamid64": "76561197960287930",
"total_level": 1429,
"total_xp": 7147016,
"url": "https://csxp.gg/players/76561197960287930",
"xp_overload": {
"active_weeks": null,
"longest_weeks": 1,
"match_url": null,
"observed_at": null,
"source": "xp_estimate"
}
},
"possible_cs_ban": false,
"rank": 1,
"rank_change": null,
"site_rank": 1,
"tier": null,
"value": 1429
},
{
"ban_note": null,
"new_entry": false,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 27,
"commends": {
"friendly": 231,
"leader": 178,
"teaching": 163,
"total": 572
},
"cs_updated_at": 1769132289,
"level": 2,
"level_xp": 3921,
"name": "Marlow",
"steam_updated_at": 1790075012,
"steamid64": "76561197960435530",
"total_level": 1362,
"total_xp": 6813921,
"url": "https://csxp.gg/players/76561197960435530",
"xp_overload": null
},
"possible_cs_ban": false,
"rank": 2,
"rank_change": null,
"site_rank": 2,
"tier": null,
"value": 1362
}
],
"meta": {
"leaderboard": {
"board": "overall",
"description": "Sorted by total XP level. Remaining XP breaks ties.",
"player_count": 584626,
"title": "CS2 XP Leaderboard",
"url": "https://csxp.gg/total",
"value_label": "Level"
},
"limit": 2,
"next_offset": 2,
"offset": 0,
"total": 1000,
"updated_at": 1794470201
}
}
Collectible holders by XP
GET/api/v1/collectibles/{slug}/leaderboard
The top 1,000 holders of a medal, pick'em coin or operation coin by total XP. Other collectibles have no such ranking and return a 404.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2/leaderboard?limit=2"
Example response
{
"data": [
{
"ban_note": null,
"new_entry": false,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 30,
"commends": {
"friendly": 211,
"leader": 180,
"teaching": 178,
"total": 569
},
"cs_updated_at": 1781245373,
"level": 21,
"level_xp": 699,
"name": "Juniper",
"steam_updated_at": 1815893150,
"steamid64": "76561197960265731",
"total_level": 1301,
"total_xp": 6505699,
"url": "https://csxp.gg/players/76561197960265731",
"xp_overload": {
"active_weeks": null,
"longest_weeks": 2,
"match_url": null,
"observed_at": null,
"source": "xp_estimate"
}
},
"possible_cs_ban": false,
"rank": 1,
"rank_change": null,
"site_rank": 1,
"tier": null,
"value": 1301
},
{
"ban_note": null,
"new_entry": false,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"bans": {
"community_banned": false,
"days_since_last_ban": null,
"economy_ban": null,
"game_bans": 0,
"vac_bans": 0
},
"collectible_count": 31,
"commends": {
"friendly": 155,
"leader": 146,
"teaching": 152,
"total": 453
},
"cs_updated_at": 1781243972,
"level": 11,
"level_xp": 334,
"name": "Sable",
"steam_updated_at": 1815893113,
"steamid64": "76561197960265738",
"total_level": 1251,
"total_xp": 6255334,
"url": "https://csxp.gg/players/76561197960265738",
"xp_overload": {
"active_weeks": null,
"longest_weeks": 2,
"match_url": null,
"observed_at": null,
"source": "xp_estimate"
}
},
"possible_cs_ban": false,
"rank": 2,
"rank_change": null,
"site_rank": 2,
"tier": null,
"value": 1251
}
],
"meta": {
"leaderboard": {
"collectible": "service_medal_2026_lvl2",
"player_count": 63,
"title": "2026 Service Medal Tier 2 holders by total XP",
"url": "https://csxp.gg/medals/service_medal_2026_lvl2",
"value_label": "Total Level"
},
"limit": 2,
"next_offset": 2,
"offset": 0,
"total": 63,
"updated_at": 1794470201
}
}
Collectibles
Collectible catalogue, holder history and holder changes. Needs the collectibles endpoint group.Collectibles
GET/api/v1/collectibles
The whole catalogue: every medal, coin, pin and trophy with its holder count, share of tracked accounts and rarity rank. Collectibles nobody tracked holds have no rank.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/collectibles?category=genuine_pin&sort=rarity"
Example response
{
"data": [
{
"category": "genuine_pin",
"holders": 515,
"id": 6002,
"image_url": "https://csxp.gg/images/collectible_pin_guardianelite_small_png.png",
"name": "Genuine Guardian Elite Pin",
"rarity_rank": 229,
"section": null,
"share_percent": 0.088091,
"slug": "genuine-guardian-elite-pin",
"url": "https://csxp.gg/collectibles/genuine-guardian-elite-pin"
},
{
"category": "genuine_pin",
"holders": 527,
"id": 6001,
"image_url": "https://csxp.gg/images/collectible_pin_dust2_small_png.png",
"name": "Genuine Dust II Pin",
"rarity_rank": 231,
"section": null,
"share_percent": 0.090143,
"slug": "genuine-dust-ii-pin",
"url": "https://csxp.gg/collectibles/genuine-dust-ii-pin"
}
],
"meta": {
"count": 34,
"tracked_accounts": 584626,
"updated_at": 1794470201
}
}
Collectible
GET/api/v1/collectibles/{slug}
One collectible: its description, when it could be earned, its other tiers or variants, related items from the same event, and this week's newest holders.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2"
Example response
{
"data": {
"awarded_from": "2026-01-01",
"awarded_until": "2026-12-31",
"category": "service_medal",
"description": [
"Awarded for outstanding service and achievement in 2026."
],
"has_leaderboard": true,
"holders": 63,
"id": 5271,
"image_url": "https://csxp.gg/images/service_medal_2026_lvl2_small_png.png",
"name": "2026 Service Medal Tier 2",
"ranked_collectibles": 534,
"rarity_rank": 210,
"recent_holders": [],
"related": [],
"section": "2026",
"share_percent": 0.010776,
"short_label": "Tier 2",
"siblings": [
{
"category": "service_medal",
"holders": 23462,
"id": 5270,
"image_url": "https://csxp.gg/images/service_medal_2026_lvl1_small_png.png",
"name": "2026 Service Medal Tier 1",
"section": "2026",
"share_percent": 4.013164,
"slug": "service_medal_2026_lvl1",
"url": "https://csxp.gg/collectibles/service_medal_2026_lvl1"
},
{
"category": "service_medal",
"holders": 9,
"id": 5272,
"image_url": "https://csxp.gg/images/service_medal_2026_lvl3_small_png.png",
"name": "2026 Service Medal Tier 3",
"section": "2026",
"share_percent": 0.001539,
"slug": "service_medal_2026_lvl3",
"url": "https://csxp.gg/collectibles/service_medal_2026_lvl3"
}
],
"slug": "service_medal_2026_lvl2",
"url": "https://csxp.gg/collectibles/service_medal_2026_lvl2"
},
"meta": {
"tracked_accounts": 584626,
"updated_at": 1794470201
}
}
Collectible holder history
GET/api/v1/collectibles/{slug}/history
The holder count over time. With meta.resolution of daily, there is one point per UTC day with that day's gains, losses and ban changes; otherwise the points are sampled counts.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2/history"
Example response
{
"data": [
{
"at": 1794095999,
"banned": 0,
"gained": 2,
"holders": 61,
"holders_excluding_banned": 60,
"lost": 0,
"restored": 0
},
{
"at": 1794182399,
"banned": 0,
"gained": 1,
"holders": 62,
"holders_excluding_banned": 61,
"lost": 0,
"restored": 0
},
{
"at": 1794268799,
"banned": 1,
"gained": 1,
"holders": 63,
"holders_excluding_banned": 61,
"lost": 0,
"restored": 0
}
],
"meta": {
"collectible": "service_medal_2026_lvl2",
"count": 120,
"resolution": "daily"
}
}
Collectible holder changes
GET/api/v1/collectibles/{slug}/changes
The accounts that gained or lost a collectible in a date range, oldest first, 50 per page, with the totals for the range in meta.summary. kind is first_seen when the account already held it at its first observation, and otherwise gained, lost, banned or restored. Pass meta.next_cursor as cursor for the next page.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/collectibles/service_medal_2026_lvl2/changes?from=2026-11-01&to=2026-11-07"
Example response
{
"data": [
{
"at": 1793523641,
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg",
"delta": 1,
"kind": "gained",
"name": "Juniper",
"steamid64": "76561197960265731",
"url": "https://csxp.gg/players/76561197960265731"
},
{
"at": 1793610207,
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg",
"delta": 1,
"kind": "first_seen",
"name": "Sable",
"steamid64": "76561197960265738",
"url": "https://csxp.gg/players/76561197960265738"
}
],
"meta": {
"collectible": "service_medal_2026_lvl2",
"count": 50,
"from": "2026-11-01",
"next_cursor": "1793995112:76561197960265738",
"summary": {
"banned": 0,
"gained": 57,
"lost": 0,
"net": 57,
"restored": 0
},
"to": "2026-11-07"
}
}
Site data
Activity and site-wide statistics. Needs the site endpoint group.Recent activity
GET/api/v1/activity
The week's biggest XP gains, leaderboard climbs, newly seen rare collectibles, 2026 service medal tier-ups and XP Overload streaks gained and lost, as shown on csxp.gg/activity.
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/activity"
Example response
{
"data": {
"rank_climbs": [
{
"board": "overall",
"climbs": [
{
"from_rank": 412,
"passed": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Sable",
"steamid64": "76561197960265738",
"url": "https://csxp.gg/players/76561197960265738"
},
"places": 7,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Juniper",
"steamid64": "76561197960265731",
"url": "https://csxp.gg/players/76561197960265731"
},
"to_rank": 405
}
],
"since": 1793729723,
"title": "CS2 XP Leaderboard"
}
],
"rare_collectibles": [
{
"collectible": {
"category": "pickem_coin",
"holders": 4,
"id": 5312,
"image_url": "https://csxp.gg/images/cologne2026_coin_bronze_small_png.png",
"name": "Cologne 2026 Coin",
"section": "Cologne 2026",
"share_percent": 0.000684,
"slug": "cologne2026_coin_bronze",
"url": "https://csxp.gg/collectibles/cologne2026_coin_bronze"
},
"first_seen_at": 1794301122,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Marlow",
"steamid64": "76561197960435530",
"url": "https://csxp.gg/players/76561197960435530"
}
}
],
"service_medal_2026_tiers": [
{
"at": 1794412877,
"from_tier": 1,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Kestrel",
"steamid64": "76561197960287930",
"url": "https://csxp.gg/players/76561197960287930"
},
"to_tier": 2
}
],
"xp_gains": {
"day": [
{
"from_at": 1794383991,
"from_total_level": 1428,
"from_total_xp": 7141204,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Kestrel",
"steamid64": "76561197960287930",
"url": "https://csxp.gg/players/76561197960287930"
},
"to_at": 1794466310,
"to_total_level": 1429,
"to_total_xp": 7147016,
"xp_gained": 5812
}
],
"week": [
{
"from_at": 1793866102,
"from_total_level": 1421,
"from_total_xp": 7108650,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Kestrel",
"steamid64": "76561197960287930",
"url": "https://csxp.gg/players/76561197960287930"
},
"to_at": 1794466310,
"to_total_level": 1429,
"to_total_xp": 7147016,
"xp_gained": 38366
}
]
},
"xp_overload": {
"gained": [
{
"at": 1794362400,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Marlow",
"steamid64": "76561197960435530",
"url": "https://csxp.gg/players/76561197960435530"
},
"weeks": 4
}
],
"lost": [
{
"at": 1794362400,
"player": {
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"name": "Sable",
"steamid64": "76561197960265738",
"url": "https://csxp.gg/players/76561197960265738"
},
"weeks": 11
}
]
}
},
"meta": {
"players_measured": 90606,
"tracked_accounts": 584626,
"updated_at": 1794470201,
"url": "https://csxp.gg/activity"
}
}
Site statistics
GET/api/v1/stats
Totals across tracked accounts and the distributions of levels, Commends, collectibles and 2026 service medal tiers, as shown on csxp.gg/stats.
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/stats"
Example response
{
"data": {
"collectibles_per_account": [
{
"accounts": 516,
"collectibles": 0
},
{
"accounts": 32767,
"collectibles": 1
}
],
"commends": {
"accounts_by_total": [
{
"accounts": 11132,
"from": 0,
"to": 0
},
{
"accounts": 104066,
"from": 1,
"to": 9
}
],
"friendly": {
"accounts": 567821,
"received": 39561326
},
"leader": {
"accounts": 560555,
"received": 38094844
},
"teaching": {
"accounts": 557181,
"received": 37791857
}
},
"current_level": [
{
"accounts": 22123,
"level": 0
},
{
"accounts": 22346,
"level": 1
}
],
"service_medal_2026_tier": [
{
"accounts": 561091,
"tier": 0
},
{
"accounts": 23462,
"tier": 1
}
],
"total_level": {
"accounts_by_level": [
{
"accounts": 0,
"from": 0,
"to": 0
},
{
"accounts": 0,
"from": 1,
"to": 9
}
],
"leveled_accounts": 584626,
"top_slices": [
{
"accounts": 58605,
"top_percent": 10.0,
"total_level": 565
},
{
"accounts": 5868,
"top_percent": 1.0,
"total_level": 887
}
]
},
"totals": {
"collectibles_held": 5289445,
"commends_received": 115448027,
"levels_earned": 121739323,
"service_medal_2026_holders": 23535,
"tracked_accounts": 584626
}
},
"meta": {
"updated_at": 1794470201,
"url": "https://csxp.gg/stats"
}
}
Search
Name search, collectible holder search and vanity resolution. Needs the search endpoint group.Search players by name
GET/api/v1/search/players
Players whose current or past Steam name contains the text, most recently seen first. Very common names return the first matches found with meta.partial set and no further pages.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/search/players?name=kestrel"
Example response
{
"data": [
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"collectible_count": 35,
"name": "Kestrel",
"steamid64": "76561197960287930",
"total_level": 1429,
"total_xp": 7147016,
"url": "https://csxp.gg/players/76561197960287930"
},
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"collectible_count": 25,
"name": "kestrel_cs",
"steamid64": "76561197960265731",
"total_level": 746,
"total_xp": 3731181,
"url": "https://csxp.gg/players/76561197960265731"
}
],
"meta": {
"page": 1,
"page_size": 20,
"pages": 2,
"partial": false,
"query": "kestrel",
"total": 21
}
}
Search players by collectibles
GET/api/v1/search/holders
Players holding a set of collectibles, by total XP. Only the first 1,000 can be paged through; meta.total counts all of them.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/search/holders?collectible=service_medal_2026_lvl2,5-year-veteran-coin"
Example response
{
"data": [
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"collectible_count": 30,
"name": "Juniper",
"steamid64": "76561197960265731",
"total_level": 1301,
"total_xp": 6505699,
"url": "https://csxp.gg/players/76561197960265731"
},
{
"avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
"collectible_count": 31,
"name": "Sable",
"steamid64": "76561197960265738",
"total_level": 1251,
"total_xp": 6255334,
"url": "https://csxp.gg/players/76561197960265738"
}
],
"meta": {
"max_results": 1000,
"page": 1,
"page_size": 20,
"pages": 4,
"total": 63
}
}
Resolve a Steam profile
GET/api/v1/resolve
The SteamID64 behind a vanity name or a Steam profile link.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/resolve?query=https://steamcommunity.com/id/kestrel"
Example response
{
"data": {
"resolved_from": "vanity",
"steamid64": "76561197960287930",
"url": "https://csxp.gg/players/76561197960287930"
},
"meta": {}
}
Feeds
Snapshot feed of every newly recorded profile change. Needs the feeds endpoint group.Snapshot feed
GET/api/v1/feeds/snapshots
Every newly recorded change to a tracked account's level, XP, Commends or collectibles, in the order it was stored, with what changed since the account's previous observation. Call it without after to get a starting cursor, then poll with the latest meta.next_after; when meta.caught_up is true, wait before asking again. Rows appear about 30 seconds after they are recorded. The feed keeps the most recent five million snapshots: an older cursor returns 410 cursor_expired.
Parameters
Example request
curl -H "Authorization: Bearer $CSXP_API_KEY" \
"https://csxp.gg/api/v1/feeds/snapshots?after=412345678&limit=2"
Example response
{
"data": [
{
"collectibles": [
874,
970,
5270
],
"collectibles_added": [
5270
],
"collectibles_removed": [],
"commends": {
"friendly": 41,
"leader": 38,
"teaching": 35
},
"exact_xp": true,
"id": 412345679,
"level": 2,
"level_xp": 312,
"previous": {
"commends": {
"friendly": 41,
"leader": 38,
"teaching": 35
},
"exact_xp": true,
"last_seen_at": 1794381200,
"level": 40,
"recorded_at": 1794294800,
"total_level": 279,
"total_xp": 1399104
},
"recorded_at": 1794467512,
"steamid64": "76561197960265731",
"total_level": 281,
"total_xp": 1405312,
"url": "https://csxp.gg/players/76561197960265731",
"xp_gained": 6208
},
{
"collectibles": [],
"collectibles_added": null,
"collectibles_removed": null,
"commends": {
"friendly": 0,
"leader": 0,
"teaching": 0
},
"exact_xp": true,
"id": 412345683,
"level": 3,
"level_xp": 1190,
"previous": null,
"recorded_at": 1794467518,
"steamid64": "76561197960265738",
"total_level": 3,
"total_xp": 16190,
"url": "https://csxp.gg/players/76561197960265738",
"xp_gained": null
}
],
"meta": {
"caught_up": false,
"count": 2,
"next_after": 412345683,
"oldest_after": 407350112
}
}