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

​
概要

ポストコンプライアンス

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

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

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

非同期処理

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

大規模データセット

数百万件のIDを処理

​
仕組み

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

​
エンドポイント

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

​
ジョブの種類

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

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

​
ポストイベント

EventDescription
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"
  }'

​
はじめに

前提条件

クイックスタート

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

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

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

APIリファレンス

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