BOOKERS は、はじめから 「自動で投稿する」ための場所でした
STORY
START
はじまり
開発者が趣味で作った競馬予想 AI の予想を、記事にして届けようとしたのが始まりです。ところが、記事を自動で投稿できるサービスが見つかりませんでした。
API
記事投稿 API
そこで BOOKERS は、最初から記事投稿 API を用意しました。いまは画像や買い目も、API から登録できます。
NOW
AI アシスタントからも
同じ操作を、Claude や ChatGPT から言葉で頼むこともできます。プログラムでも、言葉でも、好きなほうで。
API でできること
ENDPOINTS
記事の下書きから公開、画像、買い目まで。 BOOKERS の画面でする操作の多くを、API から呼べます。
記事
- POST下書きを作る
/api/postdraftcreate/ - POST作って、すぐ公開する
/api/postcreate/ - PATCH下書きのまま直す
/api/postdraftupdate/{uuid}/ - PATCH直して、公開する
/api/postupdate/{uuid}/ - GET自分の記事の一覧・詳細
/api/postcreate/ ・ /api/postupdate/{uuid}/
画像・添付
- POST記事に入れる画像
/api/postimageupload/ - PATCHサムネイル
/api/postthumbnailimageupdate/{uuid}/ - PATCHダウンロードコンテンツ (CSV など)
/api/postdlcupdate/{uuid}/
広める・まとめる
- PATCHハッシュタグ
/api/posthashtagupdate/{uuid}/ - PATCHX のリポスト・いいねキャンペーン
/api/postcampaignupdate/{uuid}/ - POSTマガジンに入れる・外す
/api/magazinepostcreate/ ・ /api/magazinepostdelete/
競馬予想
- GETレースを探す (日付・開催場・R)
/api/recorder/race/find/ - POST買い目を登録する (削除は DELETE)
/api/recorder/bet/edit/ - GET自分の買い目と、的中・払戻
/api/recorder/mybet/ - POST見解を登録する (削除は DELETE)
/api/recorder/racecomment/edit/ - GET参加中のリーグ
/api/league/my/
項目とサンプルコードは API ドキュメント にあります。
たとえば、こんな使い方
USE CASES
予想 AI の結果を、そのまま記事に
予想や分析を出すプログラムから、記事を投稿できます。BOOKERS が生まれたときと同じ使い方です。
無料の記事を、毎日決まった時間に
価格を省けば、無料の記事になります。毎日の更新を、読者に無料で届けられます。
その日の買い目を、まとめて登録
レースを探して、買い目を一括で登録。記事に買い目カードを埋め込むこともできます。
集計データを、記事に添えて
CSV などのファイルを、ダウンロードコンテンツとして記事に付けられます。
BOOKERS について
ABOUT
BOOKERS は、記事を書いて届けるためのプラットフォームです。 API から投稿した記事も、無料でも有料でも公開できます。
手数料FEE
無料の記事
0円
手数料はかかりません。
有料の記事
7.5%〜
クレジットカード決済。決済手数料もコミコミです。
定期購読・メンバーシップ
10%〜
クレジットカード決済。
- キャリア決済
- 20%
- コイン決済
- 15%
- Paidy 後払い決済
- 15%
- 販売価格の上限
- 5 万円
- 銀行振込手数料
- 250 円
- 最低出金額
- 1,000 円
- 支払いサイクル
- 月末締め翌月末 お急ぎ振込で最短翌営業日
- API の利用
- 追加料金なし
手数料は、有料の記事などが売れたときに売上からかかります。最新の料率と条件は BOOKERS とは のページをご覧ください。
機能FEATURES
記事投稿 API
投稿を自動にできる API。AI アシスタント連携の土台です。
SNS 拡散支援
X・Instagram・YouTube でのリポストやフォローで、無料・割引にできます。
定期購読マガジン
続けて届ける記事を、定期購読にまとめられます。
メンバーシップ
オンラインサロンのような、会員の場を作れます。
マガジン販売
記事をまとめて販売できます。追加の手数料はありません。
数量限定販売
販売数を限って販売できます。追加の手数料はありません。
コピーガード
スマホや PC での、かんたんなコピーを防ぎます。
いろいろな決済
クレジットカード、キャリア決済、コイン、Paidy 後払いなどに対応。
3 ステップで始められます
HOW TO START
1
キーを確かめる
BOOKERS にログインし、アカウント設定の「APIキー」を開きます。
2
ドキュメントを読む
API ドキュメントに、エンドポイントごとの項目とサンプルコードがあります。
3
呼び出す
Authorization ヘッダーにキーを付けて呼ぶだけです。言語は問いません。
# 下書きを作る (公開はまだ)
import requests
headers = {'Authorization': 'Token あなたのAPIキー'}
data = {'title': '今週のまとめ', 'text': '# 見出し\n本文はマークダウンで書けます'}
r = requests.post('https://bookers.tech/api/postdraftcreate/', headers=headers, json=data)
print(r.json()['uuid'])APIキーは、ログインしている本人にだけ表示されます。漏れたおそれがあるときは、同じ場所から再発行できます。
使う前に、知っておきたいこと
SPECS
- 下書きと公開は、呼ぶ先で分かれる
- 下書きは
postdraftcreateとpostdraftupdate。postupdateは呼ぶと必ず公開され、フォロワーに新着が届きます。 - 本文はマークダウン
- API で読み書きできるのは、マークダウンの本文です。BOOKERS の編集画面で書いた本文は、API からは読めません。
- 記事は uuid で指す
- 記事ページの URL
/post/{uuid}/の部分です。作ったときの応答にも入っています。 - 買い目は、送った内容で置き換わる
- 同じレースの買い目は、送った内容ですべて置き換わります。登録は発走の 10 分前まで、1 回 100 件まで。馬番は 1〜18 です。
- 回数の上限
- 記事の API は 1 時間に 120 回まで。買い目・見解・リーグの API は、1 分に 60 回、1 時間に 1,000 回までです。
- キーは、パスワードと同じに
- キーを知っている人は、あなたとして記事を投稿できます。コードを公開するときは、キーを含めないでください。
プログラムを書かずに使うなら
AI ASSISTANTS
同じ操作を、Claude や ChatGPT に言葉で頼めます。キーは要りません。
よくある質問
FAQ
Q料金はかかりますか?
API の利用に、追加料金はありません。有料の記事が売れたときの手数料は、BOOKERS の画面から公開した記事と同じです。
Q無料の記事も投稿できますか?
できます。price を省くと無料の記事になります。有料にするときは、price に 0〜50,000 の金額を入れてください。
Qどの言語で使えますか?
HTTP でリクエストを送れる言語なら、何でも使えます。API ドキュメントには curl と Python のサンプルがあります。
Q買い目の API に料金はかかりますか?
買い目の登録と成績の集計は β 版の機能で、今は無料で使えます。正式に提供するときは、月 500 円程度の有料プランになる予定です。 買い目登録・収支集計機能(β 版)のお知らせを読む
Q記事に買い目を埋め込めますか?
埋め込めます。本文に [[bet:レースの uid]] だけの行を書くと、あなたが登録したそのレースの買い目カードになります。レースの uid は、レースを探す API で取得します。
QBOOKERS の編集画面で書いた記事も直せますか?
タイトルや価格、ハッシュタグは直せます。編集画面で書いた本文は API からは読み書きできないので、本文は編集画面で直してください。
QAI アシスタント連携とは何が違いますか?
記事と買い目の操作は、ほぼ同じことができます。API はプログラムから使うもの、AI アシスタント連携は Claude や ChatGPT に言葉で頼むものです。AI アシスタント連携では、キーは要りません。
API に足してほしい機能を、教えてください
「こんな操作も API でしたい」「ここが使いにくい」など、ご要望をお待ちしています。今後の改善の参考にします。