Skip to content
boatraceopenapiPublic

About

[Deprecated] A project for publishing a boatrace API with GitHub Actions and GitHub Pages. / GitHub Actions と GitHub Pages を利用してボートレース(競艇)の API を公開するプロジェクト

Topics

Resources

Stars

10 stars

Watchers

1 watching

Forks

Repository files navigation

Boatrace Open API for Results

v3 v2 license

pages-build-deployment test psalm audit sync keepalive dependabot-updates


🛑 非推奨のお知らせ

本リポジトリ(Boatrace Open API for Results)は今後の利用が推奨されません。今後は後継リポジトリの boatraceopenapi/api をご利用ください。

なお、非推奨ではありますが本リポジトリのデータ更新・API 提供自体は引き続き稼働しています。既存の利用箇所を直ちに移行する必要はなく、現状のまま継続してご利用いただくことも可能です。ただし、将来的に更新が停止される可能性もあるため、可能な範囲で後継 API への移行をご検討ください。


⚠️ 注意事項

本 API を利用する前に、以下の内容をご確認ください。

  • 非公式です。 BOAT RACE 公式サイトおよび関連団体とは一切関係ありません。
  • リアルタイムではありません。 GitHub Actions による約 3 時間間隔の定期更新のため、最新情報の反映まで数時間程度の遅れが生じる場合があります。
  • 正確性・完全性は保証していません。 収集・変換の都合により、欠損や誤りが含まれる可能性があります。
  • 公式な情報が必要な場合は、必ず BOAT RACE 公式サイトをご確認ください。
  • 利用は自己責任でお願いします。

📝 概要

この API では、ボートレース(競艇)のデータを取得できます。データは GitHub Pages 上で公開されており、JSON 形式で提供されます。

項目 内容
対応レース場 全国 24 場すべて(1 日分のデータに全場の情報を含む)
取得可能なデータ 結果

🌐 エンドポイント

v3(対応期間: 2016年08月01日以降)

https://boatraceopenapi.github.io/results/v3/YYYY/YYYYMMDD.json

v2(対応期間: 2016年10月01日以降)

https://boatraceopenapi.github.io/results/v2/YYYY/YYYYMMDD.json
  • YYYY → 年
  • YYYYMMDD → 年月日
  • 日付は日本標準時(JST / UTC+9)基準

データが存在しない日付(対応期間外・未来日付など)を指定した場合、GitHub Pages の仕様により HTTP 404 が返されます。


📦 レスポンス仕様

レスポンスの JSON 構造・各フィールドの詳細・v2 との違いについては、スキーマドキュメントを参照してください。

→ docs/schema.md

stadium_number(レース場)や racer_place_number(着順)などのコード値の意味は、後継 API のコード表を参照してください。

→ boatraceopenapi/api の docs/v1/codes.md


🤖 AI エージェントで利用する場合

Claude Code や Codex などの AI エージェントにデータの取り込みや分析を任せる場合は、次の URL を読ませてください。

https://boatraceopenapi.github.io/results/llms.txt

💡 サンプル

v3

v2


🔗 関連リポジトリ

対象 リポジトリ
後継 API boatraceopenapi/api
出走表 boatraceopenapi/programs
直前情報 boatraceopenapi/previews

📄 ライセンス

Boatrace Open API for Results のソースコードは MITライセンス の元で公開されています。

API で配信しているデータは BOAT RACE 公式サイトの公開情報を元にしており、MITライセンスの対象ではありません。データの権利は本プロジェクトにはないため、データの利用条件(商用利用を含む)についてお答えすることはできません。利用の可否は元データの権利者にご確認ください。

About

[Deprecated] A project for publishing a boatrace API with GitHub Actions and GitHub Pages. / GitHub Actions と GitHub Pages を利用してボートレース(競艇)の API を公開するプロジェクト

Topics

Resources

Stars

10 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages