バッチコンプライアンス

投稿およびユーザーのコンプライアンスステータスを一括で確認する

Batch Compliance エンドポイントを使用すると、ポスト ID またはユーザー ID のデータセットをアップロードし、現在のコンプライアンスステータスを取得できます。これにより、削除された投稿、凍結されたアカウント、その他のコンプライアンスイベントを特定できます。

​

概要

ポストコンプライアンス

投稿のステータスを一括で確認

ユーザーコンプライアンス

ユーザーのステータスを一括で確認

非同期処理

ジョブを送信し、結果を後で取得

大規模データセット

数百万件のIDを処理

---

​

仕組み

1. ジョブを作成 — type (投稿またはユーザー) とアップロード先 URL を指定します
2. ID をアップロード — 提供された URL にデータセットをアップロードします
3. 処理を待機 — ジョブは非同期で実行されます
4. 結果をダウンロード — 各 ID のコンプライアンス状況を取得します

---

​

エンドポイント

Method	Endpoint	説明
POST	/2/compliance/jobs	新しいコンプライアンスジョブを作成する
GET	/2/compliance/jobs/:id	ジョブのステータスを取得する
GET	/2/compliance/jobs	すべてのジョブを一覧表示する

---

​

ジョブの種類

タイプ	説明
tweets	ポストのコンプライアンスステータスを確認する
users	ユーザーのコンプライアンスステータスを確認する

---

​

コンプライアンスイベント

​

ポストイベント

Event	Description
deleted	ポストがユーザーによって削除されました
bounced	ポストがコンプライアンスチェックに失敗しました
protected	アカウントが非公開設定になりました
suspended	アカウントが凍結されました
scrub_geo	位置情報データが削除されました

​

ユーザーイベント

Event	説明
deleted	アカウントが削除された
suspended	アカウントが凍結された
protected	アカウントが保護された
deactivated	アカウントが無効化された

---

​

例: ジョブを作成する

curl -X POST "https://api.x.com/2/compliance/jobs" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tweets",
    "name": "my-compliance-job"
  }'

---

​

はじめに

前提条件

• 承認済みの開発者アカウント
• 開発者コンソール内のProject と App
• App のベアラートークン

クイックスタート

最初のコンプライアンスジョブを作成する

インテグレーションガイド

基本概念とベストプラクティス

APIリファレンス

エンドポイントの完全なドキュメント