koreabaseball APIkoreabaseball.com ↗
Retrieve KBO league game schedules by year and month from koreabaseball.com. Filter by team, get dates, times, matchups, and stadium data.
What is the koreabaseball API?
The koreabaseball.com API provides access to Korea Baseball Organization (KBO) league game schedules through a single endpoint, get_schedule, returning up to a full month of games with 5 fields per game: date, time, away team, home team, and stadium. Pass a year and month to pull all scheduled matchups, or include a team_id to narrow results to one club's games for that month.
curl -X POST 'https://api.parse.bot/scraper/91af86ff-58ff-41cd-98e1-26887b18cb09/get_schedule' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"year": "2026",
"month": "07",
"team_id": "LG"
}'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 koreabaseball-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: KBO Schedule SDK — bounded, re-runnable; every call capped."""
from parse_apis.koreabaseball_com_api import KBO, ParseError
client = KBO()
# List all games for a given month
for game in client.games.list(year="2026", month="07", limit=3):
print(game.date, game.time, game.away_team, "vs", game.home_team, "@", game.stadium)
# Filter by team
first_game = client.games.list(year="2026", month="07", team_id="LG", limit=1).first()
if first_game:
print("LG game:", first_game.date, first_game.time, first_game.away_team, "vs", first_game.home_team)
# Typed error handling
try:
for game in client.games.list(year="2026", month="03", limit=3):
print(game.date, game.time)
except ParseError as e:
print(f"error: {e}")
print("exercised: games.list")
Retrieve the KBO league game schedule for a given year and month. Returns all games with date, time, home team, away team, and stadium. Optionally filter by a specific team to see only that team's games. Results are auto-iterated.
| Param | Type | Description |
|---|---|---|
| yearrequired | string | 4-digit season year (e.g. 2026). |
| monthrequired | string | 1 or 2-digit month number (e.g. 7 or 07). |
| team_id | string | Team code to filter schedule for a specific team. Known codes: LG, SSG, KIA, NC, KT. Omit to return all games. |
{
"type": "object",
"fields": {
"games": "array of game objects with date, time, away_team, home_team, stadium"
},
"sample": {
"data": {
"games": [
{
"date": "07.01(수)",
"time": "18:30",
"stadium": "잠실",
"away_team": "롯데",
"home_team": "두산"
},
{
"date": "07.01(수)",
"time": "18:30",
"stadium": "광주",
"away_team": "SSG",
"home_team": "KIA"
}
]
},
"status": "success"
}
}About the koreabaseball API
What the API Returns
The get_schedule endpoint returns an array of game objects covering every scheduled KBO contest in a given month. Each object includes date, time, away_team, home_team, and stadium. These fields are sufficient to build a full-month calendar view, generate match-day notifications, or drive any display that needs to show who plays where and when.
Filtering by Team
The optional team_id parameter narrows the response to games involving a specific club. Known codes include LG, SSG, KIA, NC, and KT. Omitting the parameter returns all games across the league for the requested period. The year and month parameters are required on every call; month accepts one- or two-digit values (e.g. 7 or 07).
Coverage and Scope
The API covers the regular KBO schedule as published on koreabaseball.com. Results are auto-iterated, meaning the full month's game list is returned without requiring additional pagination calls. The data reflects the schedule as it appears on the source site, including future scheduled games and any already-played contests within the requested month.
The koreabaseball API is a managed, monitored endpoint for koreabaseball.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when koreabaseball.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 koreabaseball.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 month-by-month KBO game calendar showing home, away, and stadium for each matchup
- Send fan notifications when a specific team's next game is scheduled using
team_idfiltering - Aggregate stadium usage data across a season by collecting the
stadiumfield over multiple months - Cross-reference KBO schedules with travel itineraries to identify games happening in a city on a given date
- Track how often each team hosts home games by counting
home_teamoccurrences across months - Populate a sports betting or fantasy app with upcoming KBO fixtures and game times
| 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 koreabaseball.com have an official developer API?+
What exactly does the `get_schedule` endpoint return for each game?+
date (the calendar date of the game), time (scheduled start time), away_team, home_team, and stadium. No play-by-play, scores, or standings data is included in the response.Which team codes work with the `team_id` filter?+
LG, SSG, KIA, NC, and KT. Other KBO clubs may be supported by their standard abbreviations, but only these five are explicitly confirmed in the endpoint specification.Does the API return game scores or historical results?+
Can I retrieve a full season's schedule in one call?+
year and month parameters are both required, so each call covers one calendar month. To build a full-season schedule, you would make separate calls for each month of the KBO season. You can fork this API on Parse and revise it to add a season-level endpoint that aggregates multiple months automatically.