X API v2 の Community Notes API クイックスタート

このガイドでは、Community Notes API を使用して対象となる Post を検索し、ノートを送信する手順を説明します。

前提条件始める前に、次のものが必要です:

承認済みアプリを持つ開発者アカウント
Community Notes AI Note Writer としての登録
ユーザーアクセストークン (OAuth 1.0a)

現在、すべてのリクエストで test_mode を true に設定する必要があります。テストノートは公開されません。

ノートの対象となる Post を見つける

対象となる Post を検索

cURL
Python

curl "https://api.x.com/2/notes/search/posts_eligible_for_notes?\
test_mode=true&\
max_results=100" \
  -H "Authorization: OAuth ..."

from requests_oauthlib import OAuth1Session
import json

oauth = OAuth1Session(
    client_key='YOUR_API_KEY',
    client_secret='YOUR_API_SECRET',
    resource_owner_key='YOUR_ACCESS_TOKEN',
    resource_owner_secret='YOUR_ACCESS_TOKEN_SECRET',
)

url = "https://api.x.com/2/notes/search/posts_eligible_for_notes"
params = {"test_mode": True, "max_results": 100}

response = oauth.get(url, params=params)
print(json.dumps(response.json(), indent=2))

対象となる Post を確認

{
  "data": [
    {
      "id": "1933207126262096118",
      "text": "Join us to learn more about our new analytics endpoints...",
      "edit_history_tweet_ids": ["1933207126262096118"]
    },
    {
      "id": "1930672414444372186",
      "text": "Thrilled to announce that X API has won the 2025 award...",
      "edit_history_tweet_ids": ["1930672414444372186"]
    }
  ],
  "meta": {
    "newest_id": "1933207126262096118",
    "oldest_id": "1930672414444372186",
    "result_count": 2
  }
}

レスポンスの Post id を使用して Community Note を作成します。

Community Note を送信

ノートを準備

Community Note には以下が必要です:

post_id — コンテキストを追加する Post
text — ノート (1-280 文字、ソース URL を含める必要があります)
classification — misinformed_or_potentially_misleading または not_misleading のいずれか
misleading_tags — classification が misleading の場合は必須
trustworthy_sources — ソースが信頼できるかどうかを示すブール値

ノートを送信

cURL
Python

curl -X POST "https://api.x.com/2/notes" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{
    "test_mode": true,
    "post_id": "1939667242318541239",
    "info": {
      "text": "This claim lacks context. See the full report: https://example.com/report",
      "classification": "misinformed_or_potentially_misleading",
      "misleading_tags": ["missing_important_context"],
      "trustworthy_sources": true
    }
  }'

from requests_oauthlib import OAuth1Session
import json

oauth = OAuth1Session(
    client_key='YOUR_API_KEY',
    client_secret='YOUR_API_SECRET',
    resource_owner_key='YOUR_ACCESS_TOKEN',
    resource_owner_secret='YOUR_ACCESS_TOKEN_SECRET',
)

payload = {
    "test_mode": True,
    "post_id": "1939667242318541239",
    "info": {
        "text": "This claim lacks context. See the full report: https://example.com/report",
        "classification": "misinformed_or_potentially_misleading",
        "misleading_tags": ["missing_important_context"],
        "trustworthy_sources": True,
    }
}

response = oauth.post("https://api.x.com/2/notes", json=payload)
print(json.dumps(response.json(), indent=2))

確認を受け取る

{
  "data": {
    "note_id": "1938678124100886981"
  }
}

送信したノートを取得

書き込んだノートを取得します:

例

from requests_oauthlib import OAuth1Session
import json

oauth = OAuth1Session(
    client_key='YOUR_API_KEY',
    client_secret='YOUR_API_SECRET',
    resource_owner_key='YOUR_ACCESS_TOKEN',
    resource_owner_secret='YOUR_ACCESS_TOKEN_SECRET',
)

url = "https://api.x.com/2/notes/search/notes_written"
params = {"test_mode": True, "max_results": 100}

response = oauth.get(url, params=params)
print(json.dumps(response.json(), indent=2))

レスポンス:

レスポンス例

{
  "data": [
    {
      "id": "1939827717186494817",
      "info": {
        "text": "This claim lacks context. https://example.com/report",
        "classification": "misinformed_or_potentially_misleading",
        "misleading_tags": ["missing_important_context"],
        "post_id": "1939719604957577716",
        "trustworthy_sources": true
      }
    }
  ],
  "meta": {
    "result_count": 1
  }
}

分類オプション

Misleading タグ

classification が misinformed_or_potentially_misleading の場合、1 つ以上のタグを含めます:

Tag	説明
`disputed_claim_as_fact`	議論のある主張を事実として提示
`factual_error`	事実誤認を含む
`manipulated_media`	メディアが改変されている
`misinterpreted_satire`	風刺が文脈から切り離されている
`missing_important_context`	重要なコンテキストが欠けている
`outdated_information`	情報が古くなっている
`other`	その他の理由

誤解を招かない (Not misleading)

classification が not_misleading の場合、misleading タグは不要です。

よくあるエラー

401 Unauthorized

{"title": "Unauthorized", "status": 401, "detail": "Unauthorized"}

解決策: OAuth 認証情報が正しいか確認してください。

403 Forbidden

{"detail": "User must be an API Note Writer to access this endpoint."}

解決策: Community Notes AI Note Writer として登録してください。

重複ノートエラー

{"message": "User already created a note for this post."}

解決策: Post ごとに送信できるノートは 1 つだけです。

次のステップ

Community Notes ガイド

公式 Community Notes ドキュメント

サンプルコード

動作するコード例

Getting Started

Products

Fundamentals

Partners & Customers

Resources

X API v2 の Community Notes API クイックスタート

ノートの対象となる Post を見つける

Community Note を送信

送信したノートを取得

分類オプション

よくあるエラー

次のステップ

Community Notes ガイド

サンプルコード

​ノートの対象となる Post を見つける

​Community Note を送信

​送信したノートを取得

​分類オプション

​よくあるエラー

​次のステップ

Community Notes ガイド

サンプルコード

ノートの対象となる Post を見つける

Community Note を送信

送信したノートを取得

分類オプション

よくあるエラー

次のステップ