Leetify APIleetify.com ↗
Fetch a CS2 player's Premier rating, Leetify rating, FACEIT level/elo, Wingman rank, and match history by Steam64 ID via the Leetify API.
What is the Leetify API?
The Leetify API exposes 8 profile fields per player through its single get_premier_rating endpoint, returning a CS2 player's current Premier rating, Leetify rating, FACEIT elo and level, Wingman rank tier, overall winrate, total matches tracked, and privacy status — all keyed by Steam64 ID. It also surfaces a per-season Premier rating history, making it useful for tracking rank progression over time.
curl -X GET 'https://api.parse.bot/scraper/0c93d383-a705-4b78-b3ed-007b4e247933/get_premier_rating?steam64_id=76561198034202275' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace leetify-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: look up a CS2 player's Premier rating and season history on Leetify."""
from parse_apis.leetify_com_api import Leetify, PlayerNotFound
client = Leetify()
# Fetch a player profile by Steam64 ID.
try:
player = client.players.get(steam64_id="76561198034202275")
except PlayerNotFound:
print("No Leetify profile found for that Steam64 ID.")
raise SystemExit
print(f"{player.name} Premier: {player.premier_rating} Leetify: {player.leetify_rating}")
print(f"Win rate: {player.winrate} Matches: {player.total_matches}")
# Walk the per-season Premier history (newest first).
for season in player.premier_seasons[:3]:
print(
f" Season {season.season}: "
f"rating {season.premier_rating_min}–{season.premier_rating_max}, "
f"W/L {season.win_rate}, K/D {season.kd_ratio}, "
f"{season.matches_played_all_sources} matches"
)
print("exercised: players.get / Player fields / PremierSeason fields")
Returns the Premier (CS2 matchmaking) rating for one public Leetify profile identified by its Steam64 ID, plus the player's other current ranks (Leetify rating, FACEIT level/elo, Wingman) and a per-season Premier history. premier_rating is the current Premier rating and is null when the player holds no rating in the current season (unranked or no recent Premier matches); premier_seasons lists every CS2 season in which Leetify recorded Premier matches with the min and max rating reached (0 means matches were played but no rating was earned), newest season first. Two fixed upstream reads per call. Unknown or private/unindexed Steam64 IDs yield an input_not_found error; malformed IDs are rejected before any request.
| Param | Type | Description |
|---|---|---|
| steam64_idrequired | string | 17-digit Steam64 ID of the player (starts with 7656119), as a string to preserve digits. |
{
"type": "object",
"fields": {
"name": "current in-game display name recorded by Leetify",
"winrate": "overall win rate as a 0-1 fraction",
"faceit_elo": "FACEIT elo or null",
"steam64_id": "Steam64 ID echoed from the profile record",
"faceit_level": "FACEIT skill level 1-10 or null",
"privacy_mode": "profile visibility as reported by Leetify (e.g. public)",
"wingman_rank": "Wingman rank tier number or null",
"total_matches": "total matches tracked by Leetify across all sources",
"leetify_rating": "current Leetify rating (number, percentage-style)",
"premier_rating": "current CS2 Premier rating (integer) or null when unranked this season",
"premier_seasons": "array of per-season Premier entries: season number, premier_rating_min, premier_rating_max, matches_played_all_sources, win_rate, kd_ratio, earliest_game_at, latest_game_at (ISO timestamps)"
},
"sample": {
"data": {
"name": "s1mplecsgod",
"winrate": 0.7143,
"faceit_elo": 3555,
"steam64_id": "76561198034202275",
"faceit_level": 10,
"privacy_mode": "public",
"wingman_rank": 17,
"total_matches": 3463,
"leetify_rating": 5.23,
"premier_rating": null,
"premier_seasons": [
{
"season": 5,
"kd_ratio": 1.84,
"win_rate": 0.61,
"latest_game_at": "2026-09-01T01:11:37.000Z",
"earliest_game_at": "2026-07-12T14:36:56.000Z",
"premier_rating_max": 0,
"premier_rating_min": 0,
"matches_played_all_sources": 28
},
{
"season": 4,
"kd_ratio": 1.53,
"win_rate": 0.59,
"latest_game_at": "2026-07-04T11:25:52.000Z",
"earliest_game_at": "2026-02-13T01:15:50.000Z",
"premier_rating_max": 26979,
"premier_rating_min": 26662,
"matches_played_all_sources": 133
}
]
},
"status": "success"
}
}About the Leetify API
What the API Returns
The get_premier_rating endpoint accepts a single required parameter — steam64_id, a 17-digit string starting with 7656119 — and returns the associated public Leetify profile. The response includes the player's in-game name, their current premier_rating (an integer reflecting their CS2 matchmaking rank, or null if unranked this season), and a per-season Premier history so you can observe rating changes across competitive seasons.
Rank Fields
Beyond Premier, the response covers three additional rank dimensions. leetify_rating is Leetify's own performance metric expressed as a percentage-style number. faceit_elo and faceit_level (1–10 scale) reflect the player's FACEIT standing, both returning null for players without a linked FACEIT account. wingman_rank returns the numeric tier for the CS2 Wingman mode, also null when not ranked.
Additional Profile Fields
winrate is the player's aggregate win rate as a decimal between 0 and 1 across all tracked matches. total_matches gives the full count of matches Leetify has recorded for the player. privacy_mode indicates profile visibility as reported by Leetify — profiles set to private will not return meaningful stats. The steam64_id field is echoed back from the profile record, useful for cross-referencing in batch workflows.
The Leetify API is a managed, monitored endpoint for leetify.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when leetify.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official leetify.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a CS2 player's current Premier rating on a clan or team roster page using
premier_rating. - Compare FACEIT elo (
faceit_elo) and Premier rating side-by-side to assess cross-platform rank consistency. - Track a player's Premier rating changes season-over-season using the per-season history in the response.
- Filter tournament rosters by
faceit_levelto enforce skill-bracket requirements. - Show aggregate win rates (
winrate) andtotal_matcheson a player stats dashboard. - Verify a player's Wingman rank (
wingman_rank) for Wingman-specific league seeding. - Alert users when
privacy_modeis non-public so they can prompt profile visibility changes.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Leetify have an official developer API?+
What does `premier_rating` return for a player who hasn't played Premier this season?+
premier_rating field returns null when a player has no Premier ranking recorded for the current season. The per-season history in the response can still show ratings from prior seasons if they exist on the profile.Does the API return match-level statistics like kill/death ratios, headshot percentages, or individual game results?+
premier_rating, leetify_rating, faceit_elo, faceit_level, wingman_rank, winrate, and total_matches. Per-match or per-round statistics are not included. You can fork this API on Parse and revise it to add an endpoint targeting match-level data.What happens when a player profile is set to private?+
privacy_mode field reflects the profile's visibility as reported by Leetify. Private profiles will not expose full stats — rank fields and winrate may be absent or null. The API does return the privacy_mode value itself so you can handle this case programmatically.Can I look up multiple players in a single request?+
get_premier_rating endpoint accepts one steam64_id per call. Batch lookups are not currently supported. You can fork this API on Parse and revise it to add a batch endpoint that accepts multiple Steam64 IDs.