Check Twitter Account Status (Suspended / Banned) API

Check whether a Twitter account is alive, suspended, or deleted via API. $0.001 per call. GetXAPI user status endpoint - reliable ban/suspension check.

GET/twitter/user/status

This endpoint costs $0.001 per API call.

Reliably reports whether an account is alive, suspended, or not found (deleted / renamed / never existed). Unlike /user/info, suspended and not-found accounts are returned as normal data (200), not as errors — so you can branch on data.status directly.

Query Parameters

Parameter	Type	Required	Description
`userName`	string	Yes	Screen name (without @)

Notes

The check is performed via a third-party lookup, which is what makes suspension detection reliable — a suspended account cannot see its own suspended state, so self-checks are misleading.
alive, suspended, and not_found all return HTTP 200 with data.status set. This endpoint does not return a 404 for a missing user; it returns "status": "not_found".

Response

{
  "status": "success",
  "msg": "success",
  "data": {
    "userName": "example_user",
    "status": "alive",
    "id": "1234567890123456789",
    "reason": null
  }
}

Suspended account

{
  "status": "success",
  "msg": "success",
  "data": {
    "userName": "banned_user",
    "status": "suspended",
    "id": null,
    "reason": "Suspended"
  }
}

Not found (deleted / renamed / never existed)

{
  "status": "success",
  "msg": "success",
  "data": {
    "userName": "nonexistent_user",
    "status": "not_found",
    "id": null,
    "reason": null
  }
}

Response Fields

Field	Type	Description
`userName`	string	The screen name that was checked
`status`	string	`alive`, `suspended`, `not_found`, or `unavailable`
`id`	string \| null	Unique user ID (present when `alive`; may be present for `suspended`)
`reason`	string \| null	Unavailability reason from Twitter (e.g. `"Suspended"`), else `null`

Status values

Value	Meaning
`alive`	The account exists and is active.
`suspended`	The account exists but has been suspended by Twitter.
`not_found`	No such account — deleted, renamed, or never existed.
`unavailable`	The account exists but is unavailable for another reason (e.g. deactivated).

Example

curl -H "Authorization: Bearer API_KEY" "https://api.getxapi.com/twitter/user/status?userName=example_user"

const response = await fetch(
  "https://api.getxapi.com/twitter/user/status?userName=example_user",
  {
    headers: { Authorization: "Bearer API_KEY" },
  }
);
const { data } = await response.json();
if (data.status === "suspended") {
  console.log(`${data.userName} is suspended`);
}

import requests

response = requests.get(
    "https://api.getxapi.com/twitter/user/status",
    params={"userName": "example_user"},
    headers={"Authorization": "Bearer API_KEY"},
)
data = response.json()["data"]
print(data["status"])  # alive | suspended | not_found

User Status