BOOKERS API 自動投稿ガイド — 記事販売を自動化する開発者向けチュートリアル

TOP

購入者/紹介者様へ

BOOKERSの特徴

記事紹介プログラム申込

販売者様へ

BOOKERSの特徴

機能紹介・チュートリアル

定期購読マガジン/メンバーシップ機能申込

公式からのお知らせ

注目記事一覧

特集ページ

競馬予想(New)

競艇予想(New)

競輪予想

パチ/スロ情報

テクノロジー

創作

その他

カテゴリから探す

競馬予想(New) 競艇予想(New) パチ/スロ情報ライフスタイルテクノロジービジネス創作コラムその他

ログイン

新規登録

BOOKERS API 自動投稿ガイド — 記事販売を自動化する開発者向けチュートリアル

mdi-share-variant

mdi-heart-outline

その他

参加リーグ

[[league.name]]

リーグを見る

BOOKERSガイド mdi-check-circle

2026年10月6日1:56

2026年10月6日2:05

mdi-update

無料記事/有料記事無料部分 - 更新時刻

2026年10月6日1:41 mdi-currency-jpy

mdi-update

有料記事有料部分 - 更新時刻

[[ getProduct ]]内容のご確認

BOOKERS API 自動投稿ガイド — 記事販売を自動化する開発者向けチュートリアル - BOOKERSガイド

[[support_message]]

ログイン/会員登録して購入

閉じる

mdi-help-circle0円チャージとは

割引キャンペーンを適用

閉じる

mdi-help-circle0円チャージとは

0円

0円当選無料

記事を購入して見る

円

[[ getProduct ]]内容のご確認

BOOKERS API 自動投稿ガイド — 記事販売を自動化する開発者向けチュートリアル - BOOKERSガイド

[[support_message]]

この記事は「」が適用されています。

決済方法 - クレジットカード

有料コンテンツ購入に関する確認事項

キャンセル

決済方法を選択

お支払い方法の選択

クレジットカード以外の決済方法について

キャンセル

決済方法を選択

お支払い情報の入力

カード情報必須

カード名義必須

有効期限必須

セキュリティコード必須

[[pay_error]]

キャンセル

・確認事項

決済ボタン押下後にカード会社の認証画面に移動しますので、認証を求められた場合は実施ください。これは不正利用対策のために国から導入義務付けされている本人認証サービス(3Dセキュア)です。
3Dセキュアのパスワード等が分からない場合はこちらをご参照ください。

お支払い情報の確認

以下のカードで決済してよろしいでしょうか？
[[pay_credit_list[pay_select].payment_label]]

【重要】3Dセキュア/本人確認認証にクレジットカード名義が求められるようになったため、追加入力してください

カード名義必須

キャンセル

・確認事項

お支払い方法の選択

※d払いが環境によって正常決済できないことがありますが、その場合は一定期間後に自動返金されます。即時残高のお戻しを希望される場合は、お問合せください
購入失敗時のFAQ
携帯キャリア決済以外の決済方法について

キャンセル

決済方法を選択

[[ getProduct ]]内容のご確認

BOOKERS API 自動投稿ガイド — 記事販売を自動化する開発者向けチュートリアル - BOOKERSガイド

[[support_message]]

この記事は「」が適用されています。

決済方法 - [[ payment_categories[payment_category] ]]

キャンセル

・確認事項

「購入に進む」ボタン押下後に携帯キャリア決済の認証画面に移動しますので、認証を求められた場合は実施ください。

■注意事項
・「購入に進む」ボタンは1度だけ押してください。ダブルクリックしないでください。二重決済になる可能性があります。
・キャリア側ページで認証・購入確定後、リダイレクトが複数回発生しますが、購入が完了するまでページを閉じずにそのままお待ちください（ページが切り替わった場合には購入が正常に完了しない可能性があります）

割引キャンペーンを適用

閉じる

mdi-help-circle0円チャージとは

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（bookers.tech）には、公式の記事投稿 API があります。note にはない機能で、記事の作成・公開・更新・X キャンペーン設定までを HTTP リクエストだけで完結できます。「AI が生成した予想を毎朝自動で販売開始する」「定期レポートを毎週自動配信する」といった運用が、個人でも実装できます。

このガイドは公式 API ドキュメント（bookers.tech/api/docs/）をもとに、セットアップから実運用までを解説します。コードを書く方なら、読みながら 30 分で最初の 1 本までいけるはずです。

1. API でできること — 全体像

BOOKERS API（v1.0.7 時点）で提供されている主なエンドポイントです。

分類

エンドポイント

できること

記事投稿

POST /api/postcreate/

新規投稿（即公開）

記事投稿

POST /api/postdraftcreate/

新規投稿（下書き保存）

記事確認

GET /api/postcreate/

自分の記事一覧の取得（20 件ずつページング）

記事確認

GET /api/postupdate/{uuid}/

1 記事の詳細取得

記事更新

PATCH /api/postupdate/{uuid}/

タイトル・本文・価格などの更新

キャンペーン

PATCH /api/postcampaignupdate/{uuid}/

X（Twitter）連動割引の設定

付加情報

PATCH /api/posthashtagupdate/{uuid}/

ハッシュタグの追加・更新

画像

POST /api/postimageupload/

記事内画像のアップロード

画像

PATCH /api/postthumbnailimageupdate/{uuid}/

サムネイル画像の設定

DLC

PATCH /api/postdlcupdate/{uuid}/

ダウンロードコンテンツの添付（メイン 10MB + サブ 500KB×5）

マガジン

POST /api/magazinepostcreate/

記事のマガジンへの紐づけ

マガジン

POST /api/magazinepostdelete/

紐づけの削除

つまり「記事を書く → 公開する → 割引キャンペーンを付ける → マガジンに入れる」という日常の販売オペレーションを、すべてプログラムから実行できます。

2. API キーの取得と認証

1. BOOKERS にログインし、アカウント設定の下部にある「投稿 API 用シークレットキー」を確認します（公式 FAQ: APIキーを取得したい）
2. 取得したキーを、リクエストヘッダーに次の形式で載せます:

Authorization: Token あなたのシークレットキー

⚠️ シークレットキーは第三者に知られると勝手に投稿できてしまいます。コードに直書きせず、環境変数や Secret 管理サービスに保存してください。

3. 記事投稿のサンプルコード

curl で最小の投稿

curl https://bookers.tech/api/postcreate/ \
    -X POST \
    -H 'Authorization: Token {token}' \
    -H 'Content-Type: application/json' \
    -d '{"title":"API投稿やってみた","category":2,"description":"記事の概要を書きます","text":"# Markdownで記事書けます！","price":500}'

成功すると HTTP 201 で、投稿された記事の内容（uuid を含む）が返ります。

Python での投稿（公開 + X キャンペーン設定まで）

import os
import requests

TOKEN = os.environ["BOOKERS_API_TOKEN"]
HEADERS = {
    "Authorization": f"Token {TOKEN}",
    "Content-Type": "application/json",
}

# 1) 記事を投稿（公開）
post = {
    "title": "今週の分析レポート",
    "category": 2,           # 1:その他, 2:競馬, 3:競艇, 4:競輪, 5:テクノロジー,
                             # 6:ビジネス, 7:漫画, 8:創作, 9:音楽, 10:ライフスタイル, 11:コラム
    "description": "無料部分。markdown記法対応。ここで記事の価値を伝える。",
    "text": "# 有料部分\n本命・対抗・根拠データはこちら。",
    "price": 500,            # 0〜50,000円
    "limited_number": 0,     # 数量限定販売。限定なしは0
    "is_disabled_copyguard": False,  # コピーガードを無効にする場合のみ True
}
r = requests.post("https://bookers.tech/api/postcreate/",
                  headers=HEADERS, json=post)
r.raise_for_status()
uuid = r.json()["uuid"]
print(f"公開しました: https://bookers.tech/post/{uuid}/")

# 2) X連動割引を設定（リポストで無料）
campaign = {
    "discount_campaign_category": "TW_RT_F",  # TW_RT_F:RPで無料 / TW_RT_D:RPで割引 / TW_RT_L:RPで抽選無料
    "discount_campaign_tweet": "https://twitter.com/あなたのアカウント/status/ツイートID",
    "discount_price": 0,     # TW_RT_D のときは割引後価格を設定
}
r = requests.patch(f"https://bookers.tech/api/postcampaignupdate/{uuid}/",
                   headers=HEADERS, json=campaign)
r.raise_for_status()
print("Xキャンペーンを設定しました")

覚えておくと便利なフィールド仕様

・description = 無料部分、text = 有料部分。どちらも Markdown 記法対応、改行は \n
・price は 0〜50,000 円。limited_number に 1 以上を入れると数量限定販売
・下書きにしたい場合は同じボディで POST /api/postdraftcreate/ へ
・抽選キャンペーン（TW_RT_L）は lottery_rate（当選確率%）と lottery_max_count（当選上限数）を指定

4. ユースケース — 「毎週書く」を「毎週動く」に変える

ユースケース A: AI 予想の自動販売

毎朝レースデータを取得 → 予想モデルを実行 → 結果を Markdown に整形 → postcreate で公開、までを cron で回す構成です。

[データ取得] → [予想モデル] → [Markdown整形] → POST /api/postcreate/
                                                └→ PATCH /api/postcampaignupdate/（販促）

無料部分（description）にはモデルの調子や前回結果を、有料部分（text）に当日の予想を入れる
開催日だけ動かすなら cron の曜日指定（競馬なら土日）で十分
公開後に記事 URL を X へ自動ポストすれば、販促まで一気通貫

ユースケース B: 定期レポートの自動配信

週次の市場分析・データレポートなど「定型フォーマット × 最新データ」型のコンテンツに向きます。

・テンプレート（Jinja2 など）に最新データを流し込んで text を生成
・まず postdraftcreate で下書き投稿し、人間が最終確認してから公開する運用にすれば、品質事故を防げます
・公開済み記事の数字を直したいときは PATCH /api/postupdate/{uuid}/

5. 運用時の注意

1. レートリミット: 各 API とも 1 時間あたり 120 回（公式ドキュメント記載）。通常の自動投稿では十分な枠ですが、一括移行スクリプトなどではスリープを入れてください
2. 自動生成コンテンツの品質担保: 自動化しても「売り物」であることは変わりません。下書き API + 人間の承認を挟む、生成失敗時は公開しない（raise_for_status() で止める）など、読者に不良品が届かない設計にしてください
3. 投稿ガイドラインの遵守: 自動投稿でも投稿ガイドラインの対象です。同一内容の連投などはやめましょう
4. シークレットキーの管理: キーはユーザー設定の「投稿API用シークレットキー」欄で確認できます（同画面から API ドキュメントへの導線あり）。環境変数・Secret 管理で保護し、漏洩が疑われたら再発行してください

まずは 1 リクエストから

GET /api/postcreate/（自分の記事一覧の取得）は読み取りだけなので、最初の疎通確認に最適です。

curl https://bookers.tech/api/postcreate/ -H 'Authorization: Token {token}'

これが通れば、あとは本ガイドのサンプルを組み合わせるだけです。正式なリファレンスは公式 API ドキュメントを参照してください。API へのご要望はお問い合わせフォームで受け付けています。

「自動販売の仕組みを作りたい」という技術系クリエイターの方は、公式 X（@BookersOfficial）の DM でもご相談いただけます。

特設ページ

購入者/紹介者様へ

販売者様へ

カテゴリから探す

1. API でできること — 全体像

2. API キーの取得と認証

3. 記事投稿のサンプルコード

curl で最小の投稿

Python での投稿（公開 + X キャンペーン設定まで）

覚えておくと便利なフィールド仕様

4. ユースケース — 「毎週書く」を「毎週動く」に変える

ユースケース A: AI 予想の自動販売

ユースケース B: 定期レポートの自動配信

5. 運用時の注意

まずは 1 リクエストから