TOP 購入者/紹介者様へ BOOKERSの特徴 記事紹介プログラム申込 販売者様へ BOOKERSの特徴 機能紹介・チュートリアル 手数料 AI アシスタント連携(MCP) 買い目・リーグ 記事紹介プログラム SNS 拡散支援 API 定期購読マガジン/メンバーシップ機能申込 公式からのお知らせ 注目記事一覧 特集ページ 競馬予想(New) 競艇予想(New) 競輪予想 パチ/スロ情報 テクノロジー 創作 その他 ログイン 新規登録 新規登録
BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する mdi-share-variant mdi-heart-outline 0 その他
参加リーグ
[[league.name]]
リーグを見る
BOOKERSガイド mdi-check-circle
mdi-update 無料記事/有料記事無料部分 - 更新時刻
2026年11月20日18:27 mdi-currency-jpy mdi-update 有料記事有料部分 - 更新時刻
[[ getProduct ]]内容のご確認 BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する - BOOKERSガイド
[[support_message]]
ログイン/会員登録して購入 閉じる
割引キャンペーンを適用 閉じる
0円
0円当選無料
記事を購入して見る
0
円
[[ getProduct ]]内容のご確認 BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する - BOOKERSガイド
[[support_message]]
この記事は「」が適用されています。
決済方法 - クレジットカード
有料コンテンツ購入に関する確認事項
キャンセル 決済方法を選択
お支払い方法の選択 クレジットカード以外の決済方法について キャンセル 決済方法を選択
お支払い情報の入力
カード情報 必須
カード名義 必須
有効期限 必須
セキュリティコード 必須
[[pay_error]]
キャンセル
カードで支払う
・確認事項
決済ボタン押下後にカード会社の認証画面に移動しますので、認証を求められた場合は実施ください。 これは不正利用対策のために国から導入義務付けされている本人認証サービス(3Dセキュア)です。
3Dセキュアのパスワード等が分からない場合は こちら をご参照ください。
お支払い情報の確認 以下のカードで決済してよろしいでしょうか?
[[pay_credit_list[pay_select].payment_label]]
【重要】3Dセキュア/本人確認認証にクレジットカード名義が求められるようになったため、追加入力してください
カード名義 必須
キャンセル
カードで支払う
・確認事項
決済ボタン押下後にカード会社の認証画面に移動しますので、認証を求められた場合は実施ください。 これは不正利用対策のために国から導入義務付けされている本人認証サービス(3Dセキュア)です。
3Dセキュアのパスワード等が分からない場合は こちら をご参照ください。
No
お支払い方法の選択 ※d払いが環境によって正常決済できないことがありますが、その場合は一定期間後に自動返金されます。即時残高のお戻しを希望される場合は、お問合せください
購入失敗時のFAQ
携帯キャリア決済以外の決済方法について
キャンセル 決済方法を選択
[[ getProduct ]]内容のご確認 BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する - BOOKERSガイド
[[support_message]]
この記事は「」が適用されています。
決済方法 - [[ payment_categories[payment_category] ]]
キャンセル
購入に進む
・確認事項
「購入に進む」ボタン押下後に携帯キャリア決済の認証画面に移動しますので、認証を求められた場合は実施ください。
■注意事項
・「購入に進む」ボタンは1度だけ押してください。ダブルクリックしないでください。二重決済になる可能性があります。
・キャリア側ページで認証・購入確定後、リダイレクトが複数回発生しますが、購入が完了するまでページを閉じずにそのままお待ちください(ページが切り替わった場合には購入が正常に完了しない可能性があります)
割引キャンペーンを適用 閉じる
0円
0円当選無料
記事を購入して見る
0
円
[[ getProduct ]]内容のご確認 BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する - BOOKERSガイド
[[support_message]]
この記事は「」が適用されています。
決済方法 - [[ payment_categories[payment_category] ]]
有料コンテンツ購入に関する確認事項
キャンセル
購入に進む
・確認事項
「購入に進む」ボタン押下後に携帯キャリア決済の認証画面に移動しますので、認証を求められた場合は実施ください。
■注意事項
・「購入に進む」ボタンは1度だけ押してください。ダブルクリックしないでください。二重決済になる可能性があります。
・認証・購入確定後、リダイレクトが複数回発生しますが、購入が完了するまでページを閉じずにそのままお待ちください(ページが切り替わった場合には購入が正常に完了しない可能性があります)
お支払い方法の選択
保有コイン: [[total_balance.toLocaleString()]] コイン (1コイン=1円)
残高が不足しています。
10%還元 5%還元
チャージ
最短1営業日
mdi-help-circleBOOKERSコインとは
キャンセル 決済方法を選択
[[ getProduct ]]内容のご確認 BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する - BOOKERSガイド
[[support_message]]
この記事は「」が適用されています。
決済方法 - [[ payment_categories[payment_category] ]]
キャンセル
購入に進む
mdi-flag 報告
目次
BOOKERS の API で、競馬の買い目を登録できるようになりました。
これまでの API は、記事の投稿が中心でした。今回のアップデートで、レースの検索、買い目の登録、見解の登録、結果の確認までがそろいました。予想をプログラムや AI で作っている方は、「予想を作る → 買い目を記録する → 記事にして公開する」を 1 本のスクリプトにまとめられます。
このガイドでは、最初の 1 件を登録するところから、記事に買い目カードを入れて投稿するところまでを、コード例つきで順に説明します。記事の投稿そのものの使い方は、API 自動投稿ガイドをあわせてご覧ください。

1. 買い目登録とは

レースの前に買い目を登録しておくと、レース後に結果が自動で付き、回収率と的中率が集計される機能です。登録した買い目は、カードとして記事に埋め込めます。
・対象は JRA(中央競馬) のレースです
・登録・変更・削除ができるのは、発走の 10 分前までです
・週末のレースは、金曜の昼過ぎから登録できます
・β 版で、今は無料です。正式提供の際は、月 500 円程度の有料プランになる予定です
・買い目は予想の記録です。BOOKERS が馬券を購入することはありません

2. API でできること

分類
エンドポイント
できること
レース
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 の利用に追加料金はありません。

3. はじめる前に

API キー
アカウント設定の下のほうにある「APIキー」で確認できます。リクエストのヘッダーに、次の形で付けます。
キーが漏れたおそれがあるときは、同じ場所の「APIキーを再発行」から作り直せます。コードに直接書かず、環境変数などに入れて管理してください。
成績を画面で見るための設定
アカウント設定の「買い目登録・収支集計(β 版)」で、「買い目登録・収支集計を使う」をオンにしておきます。オンにすると、著者ページに成績が表示され、編集画面でも買い目を扱えるようになります。

4. 最初の 1 件を登録する

流れは 3 つです。レースを探す、買い目を登録する、確かめる。

4-1. レースを探す

開催日、開催場、レース番号を渡すと、そのレースの情報が返ります。あとの手順で使うのは uid です。
  • date は YYYY-MM-DD の形で書きます
  • course は開催場の名前(東京、中山、京都、阪神など)です
  • round は 1〜12 です
レースがまだ登録されていないときは、404 が返ります。週末のレースは金曜の昼過ぎから登録されるので、それより前に探すと見つかりません。

4-2. 買い目を登録する

race_id に、いま取得した uid を付けて送ります。本文は買い目の配列です。
成功すると 201 で、登録された買い目が返ります。点数はサーバーが数えるので、送る必要はありません。

4-3. 確かめる

レースが確定すると、同じ一覧の is_hit(的中したか)と win_return(払戻の金額)に結果が入ります。払戻を確かめるときも、この一覧を使います。

5. 買い目の書き方

買い目 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 でどの行が違うかが返ります。

6. 知っておきたい動き

同じレースの買い目は、送った内容に置き換わります
登録は「追加」ではなく「置き換え」です。同じレースにもう一度送ると、前の買い目は消えて、新しく送った内容だけが残ります。買い目を足したいときは、残したいものも含めて全部を送り直してください。
一度に送れるのは 100 件までです
置き換えの動きなので、1 つのレースに登録できる買い目も 100 件までになります。
発走の 10 分前を過ぎると、変えられません
登録、変更、削除、見解の登録のどれも、発走の 10 分前までです。過ぎると 400 が返ります。スクリプトを時刻で動かすときは、余裕を持たせてください。
見解はレースごとに 1 つです
同じレースにもう一度送ると、上書きされます。登録した見解は、記事に埋め込んだ買い目カードの中に表示されます。

7. 買い目カードを記事に入れる

記事の本文に、次の 1 行を書きます。その位置が、登録した買い目のカードに置き換わります。
・行の途中ではなく、その行だけに書きます。文の途中に書くと、文字のまま表示されます
・有料部分(text)に書くと、買い目は購入した人だけに見えます。無料部分(description)に書くと、誰でも見られます
・カードに出るのは、記事を書いた本人が登録した買い目です

8. まとめて動かす例(Python)

レースを探し、買い目と見解を登録し、買い目カード入りの記事を下書きで作るところまでの例です。
この例は下書きで止めています。自動で作った記事は、公開する前に一度、自分の目で確かめる形をおすすめします。そのまま公開したい場合は、送り先を postcreate に変えます。

9. リーグの買い目を登録する

参加しているリーグに買い目を登録するときは、league にリーグの uuid を付けます。
  • リーグに登録できるのは、リーグが「開催中」のあいだです
  • league を付けないときは、個人の買い目として登録されます。個人の買い目とリーグの買い目は、別々に数えます
  • リーグの買い目カードを記事に入れるときは、[[bet:{race_uid}|league={league_uuid}]] と書きます
  • 1 つの記事に、違うリーグの買い目を混ぜることはできません

10. 回数の上限とエラー

回数の上限
  • 買い目・見解・リーグの 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 の秒数だけ待つ

11. コードを書かずに使う方法

同じことは、Claude や ChatGPT に言葉で頼んでもできます。BOOKERS は MCP(AI アシスタントと外部のサービスをつなぐ共通の仕組み)に対応していて、「日曜の京都 11R に、単勝 5 番を 1,000 円で登録して」と頼むだけで、買い目が登録されます。API キーは要りません。
スクリプトを組む前に、まず流れを試したいときにも向いています。競馬での頼み方は BOOKERS MCP 競馬予想ガイド、つなぎ方は BOOKERS MCP 使い方ガイドをご覧ください。

まずは 1 件から

来週末のレースを 1 つ選んで、単勝を 1 点だけ登録してみてください。レースが終わると、結果と払戻が自動で付きます。そこまで確かめられたら、あとはこのガイドの例を組み合わせるだけです。
「こういう項目も取りたい」「ここが使いにくい」といった声があれば、お問い合わせフォームからお寄せください。
*本ガイドは BOOKERS API v1.1.0(2026 年 11 月時点)に基づきます。最新の仕様は API ドキュメントをご確認ください。*
mdi-gift-outline 記事を気に入ったらサポート BOOKERSガイドさんをサポート BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する 金額
100円
500円
1000円
ログイン/会員登録して購入 閉じる
BOOKERSガイド mdi-check-circle
BOOKERS 運営がお届けする公式ガイド。記事販売のはじめ方や機能の使い方から、収益化のノウハウ、他サービスとの比較、シーズンの特集まで——「書いて稼ぐ」を支える情報をまとめています。個別のご相談はお問合せまたは X(@BookersOfficial)の DM へ。
新着記事
BOOKERS MCP 競馬予想ガイド — Claude・ChatGPT に頼んで、買い目の登録から予想記事まで
BOOKERS MCP 使い方ガイド — Claude・ChatGPT に頼んで、記事を書いて公開する
BOOKERS API 買い目登録ガイド — 買い目の登録から記事の投稿までを自動化する
AI 予想を売るなら、API 投稿で「毎朝、自動で」— 予想モデルの出力をそのまま販売記事にする方法
マガジン・限定販売ガイド — 単発売りから「継続収益 × 高単価」へ進む設計術
Copyright © 2020 - [[ new Date().getFullYear() ]] BOOKERS All rights reserved.