Holds public data for the Nippon Professional Baseball (NPB) League, a professional baseball league based in Japan.
This repository will consistently refresh Data is housed in individual releases due to ease of use, and can be accessed below. Most of the data for this repository is largely sourced from SPAIA, a Japanese sports website that just happens to have a treasure trove of NPB stats and information.
| Data point | Release | Job Status |
|---|---|---|
| Player Game Stats | Player Game Stats |  |
| Play-by-play (PBP) | PBP |  |
| Rosters | NPB Rosters |  |
| Schedules | Schedule |  |
| Schedules | Game_Standings | |
| NPB Draft | NPB Draft | |
GitHub (and by extension most Git implementations) struggles to properly handle changes to binary files, and changes to large (25+ MB) files if you're constantly making changes to files.
If you want a more in-depth explanation, @tanho63's Project Immortality: Using GitHub To Make Your Work Live Forever talk during Posit (2022) goes a bit more into detail about some of the technical reasons why this is the case.
If you would like for a feature to be added, or for a bug to be fixed you can open an issue so that it can be put under consideration. If you would like to contribute data or code to this project, please create a pull request. If everything with the request is good, I'll make the best effort possible to include that pull into this repo.
The code within this repository is governed by the MIT liscense, Wikipedia has a very good writeup on the basics of the MIT liscense if you want to learn more.
If you wish to use the data of this repository, the only thing we would like to ask is for you to please include the following text in a way where any user can see it:
This uses data sourced from the Nippon Baseball Data Repository, which can be accessed here:
https://github.com/armstjc/Nippon-Baseball-Data-Repository
And if you need to cite this repo for academic work, here is how to cite the repo for APA:
Armstrong, Joseph (2026). Nippon Baseball Data Repository (Main Branch) [Computer software].
https://github.com/armstjc/Nippon-Baseball-Data-Repository/tree/main