Skip to content

boatraceopenapi/api

Repository files navigation

Boatrace Open API

v1 license

deploy-pages test psalm audit sync sync-upcoming keepalive dependabot-updates


⚠️ 注意事項

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

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

📝 概要

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

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

🌐 エンドポイント

対応期間: 2026年01月01日以降

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

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


📦 レスポンス仕様

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

docs/v1/schema.md


💡 サンプル

各言語でのデータ取得・パース例は docs/v1/example.md を参照してください。


🔍 turnmark/api との違い

同じくボートレース(競艇)のデータを提供する turnmark/api とは、データの範囲や更新タイミングが異なります。用途に応じて使い分けてください。

本 API(boatraceopenapi/api) turnmark/api
提供データ 出走表・直前情報・結果 出走表・直前情報・結果 + オッズ
対象期間 当日分を含む(可能な限り早く提供) 前日までのデータ
更新の考え方 オッズを含まない分、速度重視 安定重視
  • オッズが必要な場合 → turnmark/api をご利用ください。
  • 当日データをできるだけ早く取得したい場合 → 本 API をご利用ください。

🤝 コントリビューション

Pull Request は受け付けておりません。

  • バグ報告・不具合の指摘 → Issues からお願いします。
  • 機能要望・改善提案 → こちらも Issues からお願いします。
  • 個人開発のため、レビュー・メンテナンスのリソースが限られています。いただいた Issue は内容を確認の上、こちらで対応・実装を判断させていただきます。

📄 ライセンス

Boatrace Open API は MIT license の元で公開されています。

About

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

Topics

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages