DM送信権限の確認

ユーザー ID またはユーザー名の DM 状態を照会します。リクエストボディには文字列配列を指定し、サービス管理アカウントで照会します。

["44196397","elonmusk"]

応答フィールドと既存のバッチ・クレジット制限は変わりません。can_dm_on_xchat=false だけでは通常の DM が送信できないとは判断できず、返された状態も送信成功を保証しません。

近日対応予定：users と任意の送信者 cookie を含むオブジェクト形式（{"users":[...],"cookie":"..."}）。本番 API ではまだ利用できず、現在は HTTP 422 を返します。対応までは上記の配列形式を使用してください。

APIリファレンスに戻る

/DM Endpoints

TwexAPI REST

POST/v2/dm/status

API 認証

AuthorizationBearer token · header必須

TwexAPIのグローバル認証トークン (Bearer Token)。ヘッダーに含める必要があります：Authorization: Bearer <YOUR_TWEXAPI_KEY>。

リクエストボディ

必須application/json

Any of:

string[]

Array of string

string

object

usersstring[]必須

照会するユーザー ID またはユーザー名の一覧です。数値の ID も文字列で指定してください。

cookiestring

任意。送信者が承認した X Cookie ヘッダー全体または生の auth_token。省略時はサービス管理アカウントを使用します。空白、null、文字列以外の値は無効です。認証失敗時に管理アカウントへ切り替わることはありません。

matches \S

レスポンス

200ユーザーの DM 状態と認証情報の一覧。

codeinteger必須

HTTP ステータスコード（200 は成功）

msgstring必須

レスポンスメッセージ（例: 'success'）

dataDMStatusModelV2[]必須

返却されるコアデータオブジェクトまたは配列

プロパティを表示

Array of DMStatusModelV2

user_idstring | any

対象ユーザーのTwitter数字ID

プロパティを表示

Any of:

string

string

any

any

screen_namestring | any

Twitterユーザー名（Handle、@なし）

プロパティを表示

Any of:

string

string

any

any

is_blue_verifiedboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

is_verified_organization_affiliateboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

verifiedboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

can_dmboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

can_dm_on_xchatboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

dm_blockingboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

passes_premium_checkboolean | any

プロパティを表示

Any of:

boolean

boolean

any

any

422パラメータバリデーションエラー

detailValidationError[]

プロパティを表示

Array of ValidationError

locstring | integer[]必須

プロパティを表示

Array of string | integer

Any of:

string

string

integer

integer

msgstring必須

レスポンスメッセージ（例: 'success'）

typestring必須

inputany

ctxobject

⚡インタラクティブテスト / Try APIPOST/v2/dm/status

Live Console

🌐対象サーバー:https://api.twexapi.io

● 本番環境レディ

🔍

公開データ取得（TwexAPIキーのみ、Twitter Cookie不要）

本エンドポイントは公開Twitterデータの検索・取得用です。TwitterアカウントやCookieは一切不要です！下記の「API認証」に TwexAPIプラットフォームキー (Bearer Token) を入力するだけで即座にテストできます。

🔑API 認証

キーを記憶コード例に同期

TwexAPI プラットフォームキー Bearer Token必須

すべてのTwexAPIエンドポイントで使用されるAPIキー。ダッシュボードで取得できます。

📝リクエストボディapplication/json

💡 クイック送信:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

リクエスト例

curl -X POST "https://api.twexapi.io/v2/dm/status" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  "44196397",
  "elonmusk"
]'

const response = await fetch("https://api.twexapi.io/v2/dm/status", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
  "44196397",
  "elonmusk"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/v2/dm/status",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "44196397",
  "elonmusk"
],
)

レスポンス例

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "user_id": "string",
      "screen_name": "string",
      "is_blue_verified": true,
      "is_verified_organization_affiliate": true,
      "verified": true,
      "can_dm": true,
      "can_dm_on_xchat": true,
      "dm_blocking": true,
      "passes_premium_check": true
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}