MyKBOStats APImykbostats.com ↗
Access KBO standings, schedules, rosters, player profiles, game box scores, and statistical leaderboards for all 10 Korean Baseball Organization teams.
What is the MyKBOStats API?
The MyKBOStats API covers the full Korean Baseball Organization across 12 endpoints, returning team standings, weekly schedules, game-level box scores, player profiles, and stat leaderboards. The get_game_detail endpoint alone returns inning-by-inning line scores plus per-player batting and pitching stat lines for both teams. Whether you're building a KBO dashboard or tracking individual player performance across seasons, this API exposes the data needed to do it.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/15827022-e651-4236-87ee-c090090d99eb/get_standings' \ -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 mykbostats-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: MyKBO Stats API — standings, teams, schedules, player search, leaderboards."""
from parse_apis.MyKBO_Stats_API import MyKBO, StatCode, NotFound
client = MyKBO()
# Get league standings — all 10 teams ranked
for standing in client.team_standings.list(limit=3):
print(f"#{standing.rank} {standing.team_name} ({standing.wins}W-{standing.losses}L) PCT {standing.pct}")
# Get a team and explore its roster via instance method
team = client.teams.get(team_id="6-LG-Twins")
print(f"\nTeam: {team.team_name}, Avg Age: {team.avg_age}")
roster = team.roster()
for pitcher in roster.pitchers[:2]:
print(f" Pitcher: {pitcher.name} ({pitcher.position}) ERA: {pitcher.era}")
# Schedule for a week — each day's games
for day in client.schedule_days.list(date="2026-06-30", limit=2):
print(f"\n{day.date}:")
for game in day.games[:2]:
print(f" {game.away_team} @ {game.home_team} — {game.status}")
# Stat leaderboard with enum
for leader in client.leaders.list(stat_code=StatCode.BA, limit=3):
print(f" {leader.rank___player} ({leader.team})")
# Search players by name and navigate typed results
search_resp = client.player_search_responses.search(query="Kim")
for team_name, group in list(search_resp.results.items())[:1]:
print(f"\n{group.name} matches:")
for player in group.results[:3]:
print(f" [{player.active}] {player.title} (id={player.id})")
# Typed error handling
try:
client.teams.get(team_id="999-Fake-Team")
except NotFound as exc:
print(f"Expected error: {exc}")
print("\nexercised: team_standings.list / teams.get / team.roster / schedule_days.list / leaders.list / player_search_responses.search")
Get current KBO standings including wins, losses, draws, winning percentage, and games back for all 10 teams. Returns the full league table ordered by rank. Each team entry includes a team_id usable for team detail, roster, and depth chart lookups.
No input parameters required.
{
"type": "object",
"fields": {
"standings": "array of team standing objects with rank, team_name, team_id, wins, losses, draws, pct, gb"
},
"sample": {
"data": {
"standings": [
{
"gb": "0.0",
"pct": ".623",
"rank": "1",
"wins": "38",
"draws": "0",
"losses": "23",
"team_id": "6-LG-Twins",
"team_name": "LG Twins"
}
]
},
"status": "success"
}
}About the MyKBOStats API
Standings, Schedules, and Game Data
The get_standings endpoint returns rank, wins, losses, draws, winning percentage, and games back for all 10 KBO teams — no inputs required. For game-level data, get_schedule accepts an optional date parameter in YYYY-MM-DD format and returns the full week of games containing that date, organized by day with away_team, home_team, away_score, home_score, and status per game. Completed games carry a game_id that feeds directly into get_game_detail, which returns a full line score array, per-player batting stat objects, and per-player pitching stat objects for both teams.
Team and Roster Data
get_team_list returns aggregate team-level metrics including fans, handedness splits (rhh_lhh_sh, rhp_lhp), avg_age, avg_game_time, and avg_home_attendance for every team. get_team_detail accepts a team_id (e.g., '6-LG-Twins') and returns franchise metadata: home_stadium, established, championships_won, manager, and gm. get_team_roster splits the active roster into hitters — with ba, ops, hr, rbi, and sb — and pitchers — with era, whip, ip, so, and k_bb. get_team_depth_chart goes further, returning the starting rotation, bullpen, spot_starters, and positional assignments.
Player and Statistical Data
search_players accepts a query string and returns matches grouped by team, each result carrying a player id for use with get_player_profile. That endpoint returns biographical fields (throws_bats, height_weight, born, drafted) alongside a stats array of season-by-season stat lines. For league-wide rankings, get_statistics accepts a stat_code such as 'ba', 'hr', or 'era' and returns a ranked leaderboard with player, team, and the relevant stat columns.
League-Wide Views
get_win_matrix returns head-to-head records and winning percentages for every team pairing in a single response — useful for analyzing schedule strength or rivalry records. get_foreign_players lists all international players currently in the KBO split into pitchers and hitters, each with their current team and key stats.
The MyKBOStats API is a managed, monitored endpoint for mykbostats.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mykbostats.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 mykbostats.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?+
- Build a live KBO standings table using
get_standingswith wins, losses, and games-back data for all 10 teams. - Display a weekly game calendar with scores and statuses using
get_schedulekeyed to any target date. - Render full box scores including inning-by-inning line scores and individual batting/pitching lines via
get_game_detail. - Track foreign player performance across all KBO teams using
get_foreign_playershitting and pitching splits. - Show franchise history pages — stadium, championships, manager, GM — with
get_team_detailfor each team. - Build a player search with career season stats by chaining
search_playersandget_player_profile. - Visualize head-to-head matchup records between all team pairs using the
get_win_matrixresponse.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does mykbostats.com have an official developer API?+
What does get_game_detail return and what input does it need?+
game_id string obtained from a get_schedule response (e.g., '12456-SSG-vs-KT-20250422'). It returns a line_score array covering header, away-team innings/totals, and home-team innings/totals, plus two batting arrays and two pitching arrays — one per team — each containing per-player stat objects.What stat codes does get_statistics support?+
'ba' (batting average), 'hr' (home runs), and 'era' (earned run average). Other stat categories may exist on the source site but are not confirmed to work as stat_code inputs. You can fork the API on Parse and test additional codes to extend coverage.Does the API cover historical seasons or only the current year?+
get_standings, get_win_matrix, and get_foreign_players reflect current-season data. get_player_profile returns a stats array with season-by-season career lines, which includes prior seasons for that individual player. There is no dedicated historical season endpoint covering past standings, full schedules, or team-level stats by year. You can fork the API on Parse and revise it to add a historical season endpoint if the source exposes that data.Are minor league or futures league KBO rosters included?+
get_team_roster, get_team_depth_chart) cover the active KBO first-team squad only. Minor league or Futures League data is not currently returned. You can fork the API on Parse and revise it to add the missing endpoint if that data is available on the source site.