API で X Thread を作成する方法

Quick Answer

TwexAPI の Create a Tweet Thread endpoint、POST /v3/twitter/tweets/create-thread を使うと、承認済みの ordered text array を 1 回の request で X thread として公開できます。request body は順序付き items、必須の cookie または auth_token、任意の proxy を含み、response は data.tweets[] に作成された tweet ID を thread order で返します。docs では $0.001 per call の write endpoint なので、review 後にだけ publish し、返却 ID を audit、analytics、reply monitoring、retry 判断のために保存します。

FAQ

Tweet thread 作成に使う TwexAPI endpoint は？

https://api.twexapi.io の POST /v3/twitter/tweets/create-thread を使います。Bearer token で認証し、JSON body に items と cookie を渡します。proxy は任意です。

Thread 公開後に何を保存すべきですか？

internal draft ID、account reference、item position、approved text、返却された tweet_id、publish time、status、raw response を保存します。full cookie は publishing table に保存しません。

同じ thread request を自動 retry できますか？

注意が必要です。timeout の前に一部の post が作成されていると、自動 retry は duplicate thread を作る可能性があります。payload hash を保存し、tweet ID の有無を確認し、unknown または partial result は manual review に回します。

長めの更新は、1 つの X 投稿に詰め込むより thread にした方が読みやすいことがあります。プロダクト発表、調査まとめ、障害報告、創業者コメントなどは、最初に要点、次に背景、続いて根拠、最後に次の行動という順序が重要です。

TwexAPI の Create a Tweet Thread endpoint は、この順序を 1 回の request で公開できます。順序付きの items 配列、X account の cookie または auth_token を渡すと、response には作成された tweet ID が thread の順序で返ります。

これは書き込み endpoint です。content generator ではなく publishing action として扱ってください。本文は別の場所で作成し、各投稿を確認し、承認後にだけ API を呼び出します。

Endpoint と Request Fields

Answer: Endpoint と Request Fieldsは本ガイドの TwexAPI エンドポイントを Bearer で呼び出して実装します。バッチ/ページングで約 5 Credits/回・20+ QPS です。

最終版の thread 文面があり、TwexAPI に順序どおり公開させたい場合は POST /v3/twitter/tweets/create-thread を使います。

Docs では、この endpoint は $0.001 per call と記載されています。それでも、write endpoint ではすべての publish attempt を記録してください。追跡なしに retry すると、重複 thread や partial publish が起きる可能性があります。

Basic Request

Answer: Basic Requestとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

1curl --request POST \
2  --url https://api.twexapi.io/v3/twitter/tweets/create-thread \
3  --header "Authorization: Bearer $TWEXAPI_BEARER_TOKEN" \
4  --header "Content-Type: application/json" \
5  --data '{
6    "items": [
7      "1/ Research team 向けに、より明確な export flow をリリースしました。",
8      "2/ 新しい flow は各 row に query、cursor、fetched_at timestamp、raw tweet ID を保持します。",
9      "3/ これにより audit が簡単になります。source context のない spreadsheet を信じるだけでなく、各 result の出所を説明できます。"
10    ],
11    "cookie": "auth_token=...; ct0=...; twid=..."
12  }'

成功すると code、msg、data.tweets が返ります。各 item には作成された tweet id が含まれます。

{
  "code": 200,
  "msg": "success",
  "data": {
    "tweets": [
      { "id": "1234567890123456789" },
      { "id": "1234567890123456790" },
      { "id": "1234567890123456791" }
    ]
  }
}

この ID はすぐ保存します。editorial draft、公開済み thread、analytics、reply monitoring、後日の削除や修正 workflow をつなぐ key になります。

Approval Gate 付き Python Publisher

Answer: Approval Gate 付き Python Publisherとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

下の script は credential を environment variables に置き、PUBLISH_THREAD=true が明示されている場合だけ公開します。local test や CI preview で live thread を誤投稿しないための guard です。

1import os
2from datetime import datetime, timezone
3from typing import Any
4
5import requests
6
7API_URL = "https://api.twexapi.io/v3/twitter/tweets/create-thread"
8BEARER_TOKEN = os.environ["TWEXAPI_BEARER_TOKEN"]
9X_COOKIE = os.environ["TWEXAPI_X_COOKIE"]
10PROXY = os.environ.get("TWEXAPI_PROXY")
11
12def validate_thread_items(items: list[str]) -> list[str]:
13    cleaned = []
14
15    for index, item in enumerate(items, start=1):
16        text = item.strip()
17        if not text:
18            raise ValueError(f"Thread item {index} is empty")
19        cleaned.append(text)
20
21    if not cleaned:
22        raise ValueError("Thread must contain at least one post")
23
24    return cleaned
25
26def create_tweet_thread(items: list[str]) -> dict[str, Any]:
27    payload: dict[str, Any] = {
28        "items": validate_thread_items(items),
29        "cookie": X_COOKIE,
30    }
31
32    if PROXY:
33        payload["proxy"] = PROXY
34
35    response = requests.post(
36        API_URL,
37        headers={
38            "Authorization": f"Bearer {BEARER_TOKEN}",
39            "Content-Type": "application/json",
40            "Accept": "application/json",
41        },
42        json=payload,
43        timeout=60,
44    )
45    response.raise_for_status()
46    data = response.json()
47
48    if data.get("code") != 200:
49        raise RuntimeError(data.get("msg", "TwexAPI returned an error"))
50
51    return data
52
53def normalize_result(draft_id: str, response: dict[str, Any]) -> dict[str, Any]:
54    tweets = response.get("data", {}).get("tweets") or []
55    return {
56        "draft_id": draft_id,
57        "published_at": datetime.now(timezone.utc).isoformat(),
58        "tweet_ids": [tweet.get("id") for tweet in tweets if tweet.get("id")],
59        "api_code": response.get("code"),
60        "api_msg": response.get("msg"),
61        "raw_response": response,
62    }
63
64if __name__ == "__main__":
65    draft_id = "launch-notes-2026-07-14"
66    thread_items = [
67        "1/ Research team 向けに、より明確な export flow をリリースしました。",
68        "2/ 新しい flow は各 row に query、cursor、fetched_at timestamp、raw tweet ID を保持します。",
69        "3/ これにより audit が簡単になります。source context のない spreadsheet を信じるだけでなく、各 result の出所を説明できます。",
70    ]
71
72    reviewed_items = validate_thread_items(thread_items)
73
74    if os.environ.get("PUBLISH_THREAD") != "true":
75        print("Review mode only. Set PUBLISH_THREAD=true after approval.")
76        for number, text in enumerate(reviewed_items, start=1):
77            print(f"{number}: {text}")
78        raise SystemExit(0)
79
80    result = create_tweet_thread(reviewed_items)
81    print(normalize_result(draft_id, result))

server または trusted workstation で実行します。

TWEXAPI_BEARER_TOKEN="your_twexapi_bearer_token" \
TWEXAPI_X_COOKIE="auth_token=...; ct0=...; twid=..." \
PUBLISH_THREAD=true \
python publish_thread.py

投稿 session に proxy が必要な環境では、TWEXAPI_PROXY も設定します。

Practical Thread Workflow

Answer: Practical Thread Workflowとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

API call は publishing system の最後の step にします。信頼できる workflow は次のようになります。

1. Draft: thread を 1 つの大きな段落ではなく、複数の independent rows または blocks として保存します。
2. Validate: empty post、broken link、重複 numbering、account-specific X posting limits を確認します。
3. Approve: editor、operator、campaign owner が ready と判断したものだけ進めます。
4. Publish: approved version に対して POST /v3/twitter/tweets/create-thread を 1 回だけ呼びます。
5. Record: ordered tweet_ids、draft ID、publish time、raw API response を保存します。
6. Monitor: 保存した ID で replies、engagement、correction decisions を追跡します。

これは product launch で特に重要です。1 投稿目で "now live" と言い、3 投稿目の link が間違っていた場合、どの draft が承認され、どの tweet ID が作成されたかを説明できる必要があります。

Store Thread State

Answer: Store Thread Stateとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

最低限、thread の master row と item ごとの child row を保存します。

この table に full cookie を保存しないでください。credential record や secret name への reference にします。

Retry and Failure Handling

Answer: Retry and Failure Handlingとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

Thread publishing は read request ではありません。API がすでに 1 つ以上の投稿を作成した後に timeout した場合、同じ payload を無条件に retry すると duplicate が作られる可能性があります。

failure は保守的に扱います。

• 公開前に request payload hash を保存します。
• 成功時は返却された tweet ID を順序どおり保存します。
• timeout や unknown failure では、manual check または read endpoint で account state を確認してから retry を判断します。
• response の tweet ID 数が items より少ない場合は、自動 retry せず review 状態にします。
• account credential が含まれるため、browser や untrusted client からこの endpoint を呼ばないでください。

目的は投稿を完全自動化することではありません。承認済み content の公開を再現可能で reviewable にすることです。

When To Use This Endpoint

Answer: When To Use This Endpointは本ガイドの TwexAPI エンドポイントを Bearer で呼び出して実装します。バッチ/ページングで約 5 Credits/回・20+ QPS です。

投稿同士の関係と順序が重要なときに thread endpoint が向いています。

• feature details を含む product launch thread
• evidence と caveats を含む research summary
• 順序が重要な incident update
• hook、proof、call to action で構成する campaign narrative
• editor が確認済みの educational thread

single post なら通常の tweet creation endpoint を使います。long-form Markdown content なら X Article endpoints が適しています。Thread は、それぞれの短い post が単独でも読めて、全体では 1 つの sequence になる場合に最適です。

Wrap-up

Answer: Wrap-upとは、この事例で api.twexapi.io の TwexAPI Bearer API を使う手順です。通常の読み取りは 5 Credits（約 $0.10/1K）、対象プランは 20+ QPS です。2026-08-20 時点の公式 Post/User read は $5/$10 per 1K で、rate limit は endpoint ごとに異なります。

POST /v3/twitter/tweets/create-thread は、承認済みの ordered text list を公開済み X thread にし、作成された tweet ID を返します。強い実装は単純です。list を validate し、approval を必須にし、1 回だけ publish し、ordered IDs を保存し、不確かな failure は review task として扱います。

これにより、write endpoint を uncontrolled posting loop にせず、thread automation の便利さだけを残せます。