
BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する
0
BOOKERS の API で、競馬の買い目を登録できるようになりました。
これまでの API は、記事の投稿が中心でした。今回のアップデートで、レースの検索、買い目の登録、見解の登録、結果の確認までがそろいました。予想をプログラムや AI で作っている方は、「予想を作る → 買い目を記録する → 記事にして公開する」を 1 本のスクリプトにまとめられます。
このガイドでは、最初の 1 件を登録するところから、記事に買い目カードを入れて投稿するところまでを、コード例つきで順に説明します。記事の投稿そのものの使い方は、API 自動投稿ガイドをあわせてご覧ください。
レースの前に買い目を登録しておくと、レース後に結果が自動で付き、回収率と的中率が集計される機能です。登録した買い目は、カードとして記事に埋め込めます。
・対象は JRA(中央競馬) のレースです
・登録・変更・削除ができるのは、発走の 10 分前までです
・週末のレースは、金曜の昼過ぎから登録できます
・β 版で、今は無料です。正式提供の際は、月 500 円程度の有料プランになる予定です
・買い目は予想の記録です。BOOKERS が馬券を購入することはありません
・登録・変更・削除ができるのは、発走の 10 分前までです
・週末のレースは、金曜の昼過ぎから登録できます
・β 版で、今は無料です。正式提供の際は、月 500 円程度の有料プランになる予定です
・買い目は予想の記録です。BOOKERS が馬券を購入することはありません
分類
エンドポイント
できること
レース
GET /api/recorder/race/find/
開催日・開催場・レース番号からレースを探す
買い目
POST /api/recorder/bet/edit/
買い目を登録する
買い目
DELETE /api/recorder/bet/edit/
買い目を削除する
買い目
GET /api/recorder/mybet/
自分の買い目と、的中・払戻を確認する
見解
POST /api/recorder/racecomment/edit/
見解を登録・更新する
見解
DELETE /api/recorder/racecomment/edit/
見解を削除する
見解
GET /api/recorder/myracecomment/
自分の見解を一覧で見る
リーグ
GET /api/league/my/
参加中のリーグを一覧で見る
API の利用に追加料金はありません。
API キー
アカウント設定の下のほうにある「APIキー」で確認できます。リクエストのヘッダーに、次の形で付けます。
キーが漏れたおそれがあるときは、同じ場所の「APIキーを再発行」から作り直せます。コードに直接書かず、環境変数などに入れて管理してください。
成績を画面で見るための設定
アカウント設定の「買い目登録・収支集計(β 版)」で、「買い目登録・収支集計を使う」をオンにしておきます。オンにすると、著者ページに成績が表示され、編集画面でも買い目を扱えるようになります。
流れは 3 つです。レースを探す、買い目を登録する、確かめる。
開催日、開催場、レース番号を渡すと、そのレースの情報が返ります。あとの手順で使うのは uid です。
- date は YYYY-MM-DD の形で書きます
- course は開催場の名前(東京、中山、京都、阪神など)です
- round は 1〜12 です
レースがまだ登録されていないときは、404 が返ります。週末のレースは金曜の昼過ぎから登録されるので、それより前に探すと見つかりません。
race_id に、いま取得した uid を付けて送ります。本文は買い目の配列です。
成功すると 201 で、登録された買い目が返ります。点数はサーバーが数えるので、送る必要はありません。
レースが確定すると、同じ一覧の is_hit(的中したか)と win_return(払戻の金額)に結果が入ります。払戻を確かめるときも、この一覧を使います。
買い目 1 件は、次の 4 つで表します。
項目
内容
type
券種。単勝 複勝 ワイド 馬連 馬単 3連複 3連単 のどれか
bet
馬番。かっこの種類で着順の枠を分けます(下の説明)
cost
1 点あたりの金額。100 円単位で、10,000 円までです
system
買い方。通常 フォーメーション ボックス 1着流し など
bet の書き方
1 つめの枠は ( )、2 つめは [ ]、3 つめは { } で囲み、馬番をカンマで区切ります。枠の数は券種で決まります。
券種
枠の数
例
単勝・複勝
1 つ
(5)
ワイド・馬連・馬単
2 つ
(5)[8,12]
3連複・3連単
3 つ
(5)[8,12]{1,3,8,12}
馬番は 1〜18 です。枠の数が券種と合わないときや、形が違うときは、400 でどの行が違うかが返ります。
同じレースの買い目は、送った内容に置き換わります
登録は「追加」ではなく「置き換え」です。同じレースにもう一度送ると、前の買い目は消えて、新しく送った内容だけが残ります。買い目を足したいときは、残したいものも含めて全部を送り直してください。
一度に送れるのは 100 件までです
置き換えの動きなので、1 つのレースに登録できる買い目も 100 件までになります。
発走の 10 分前を過ぎると、変えられません
登録、変更、削除、見解の登録のどれも、発走の 10 分前までです。過ぎると 400 が返ります。スクリプトを時刻で動かすときは、余裕を持たせてください。
見解はレースごとに 1 つです
同じレースにもう一度送ると、上書きされます。登録した見解は、記事に埋め込んだ買い目カードの中に表示されます。
記事の本文に、次の 1 行を書きます。その位置が、登録した買い目のカードに置き換わります。
・行の途中ではなく、その行だけに書きます。文の途中に書くと、文字のまま表示されます
・有料部分(text)に書くと、買い目は購入した人だけに見えます。無料部分(description)に書くと、誰でも見られます
・カードに出るのは、記事を書いた本人が登録した買い目です
・有料部分(text)に書くと、買い目は購入した人だけに見えます。無料部分(description)に書くと、誰でも見られます
・カードに出るのは、記事を書いた本人が登録した買い目です
レースを探し、買い目と見解を登録し、買い目カード入りの記事を下書きで作るところまでの例です。
この例は下書きで止めています。自動で作った記事は、公開する前に一度、自分の目で確かめる形をおすすめします。そのまま公開したい場合は、送り先を postcreate に変えます。
参加しているリーグに買い目を登録するときは、league にリーグの uuid を付けます。
- リーグに登録できるのは、リーグが「開催中」のあいだです
- league を付けないときは、個人の買い目として登録されます。個人の買い目とリーグの買い目は、別々に数えます
- リーグの買い目カードを記事に入れるときは、[[bet:{race_uid}|league={league_uuid}]] と書きます
- 1 つの記事に、違うリーグの買い目を混ぜることはできません
回数の上限
- 買い目・見解・リーグの API: 1 分あたり 60 回、1 時間あたり 1,000 回
- 記事の API: 1 時間あたり 120 回
この 2 つは別々に数えます。買い目をたくさん登録しても、記事の投稿の枠は減りません。上限を超えると 429 が返り、Retry-After ヘッダーに待つ秒数が入ります。
よくあるエラー
状態
返る内容
対処
403
認証エラー
API キーと、ヘッダーの Token の書き方を確かめる
404
指定されたレースが見つかりません
開催日・開催場・レース番号を確かめる。週末のレースは金曜の昼過ぎから
400
出走10分前を過ぎているため編集できません
締め切り後は変えられません
400
一度に登録できる買い目は100件までです
件数を減らす
400
買い目の形式が不正です
bet のかっこと、券種ごとの枠の数を確かめる
429
回数の上限
Retry-After の秒数だけ待つ
同じことは、Claude や ChatGPT に言葉で頼んでもできます。BOOKERS は MCP(AI アシスタントと外部のサービスをつなぐ共通の仕組み)に対応していて、「日曜の京都 11R に、単勝 5 番を 1,000 円で登録して」と頼むだけで、買い目が登録されます。API キーは要りません。
来週末のレースを 1 つ選んで、単勝を 1 点だけ登録してみてください。レースが終わると、結果と払戻が自動で付きます。そこまで確かめられたら、あとはこのガイドの例を組み合わせるだけです。
「こういう項目も取りたい」「ここが使いにくい」といった声があれば、お問い合わせフォームからお寄せください。
*本ガイドは BOOKERS API v1.1.0(2026 年 11 月時点)に基づきます。最新の仕様は API ドキュメントをご確認ください。*
記事を気に入ったらサポートしよう!
新着記事

BOOKERS MCP 競馬予想ガイド — Claude・ChatGPT に頼んで、買い目の登録から予想記事まで
0
2026/11/20 19:23

BOOKERS MCP 使い方ガイド — Claude・ChatGPT に頼んで、記事を書いて公開する
0
2026/11/20 19:22

BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する
0
2026/11/20 19:15

AI 予想を売るなら、API 投稿で「毎朝、自動で」— 予想モデルの出力をそのまま販売記事にする方法
0
2026/10/6 22:07

秋 G1 がはじまりました — 予想を「売る側」で楽しんでみませんか
0
2026/10/6 20:12

YouTube 登録者を伸ばすキャンペーン設計術 — 記事販売 × 登録者特典で二重マネタイズする方法
0
2026/10/6 02:20
