Twitter shadowban test API to check X accounts

{
  "username": "NASA",
  "userId": "11348282",
  "account": "active",
  "checkedAt": "2026-11-03T02:15:00.000Z",
  "overall": "clear",
  "checks": {
    "account": {
      "verdict": "pass",
      "reason": "active",
      "evidence": {
        "profileUrl": "https://x.com/NASA"
      }
    },
    "search": {
      "verdict": "pass",
      "reason": "listed",
      "evidence": {
        "query": "from:NASA",
        "searchUrl": "https://x.com/search?q=from%3ANASA&f=live",
        "recentPostIds": [
          "2103610284464316469"
        ],
        "foundPostIds": [
          "2103610284464316469"
        ]
      }
    },
    "suggestion": {
      "verdict": "pass",
      "reason": "suggested",
      "evidence": {
        "query": "NASA",
        "suggestedUsernames": [
          "NASA"
        ]
      }
    },
    "replies": {
      "verdict": "unknown",
      "reason": "more_replies",
      "evidence": {
        "replies": [
          {
            "replyId": "2103589735449141451",
            "replyUrl": "https://x.com/i/status/2103589735449141451",
            "parentId": "2102883223948628205",
            "parentUrl": "https://x.com/i/status/2102883223948628205",
            "placement": "more_replies"
          }
        ]
      }
    },
    "replyLock": {
      "verdict": "pass",
      "reason": "replies_show",
      "evidence": {
        "checkedReplies": 2,
        "shownReplies": 2
      }
    }
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "api_key_paused",
  "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

users

{id}

shadowban

Twitter shadowban test API to check X accounts

curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id}/shadowban

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/users/{id}/shadowban"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "username": {},
  "userId": {},
  "account": "<string>",
  "checks": {
    "account": {},
    "search": {},
    "suggestion": {},
    "replies": {}
  }
}

1 credit per profile, post, suggestion & reply in the answerAll plans from $0.00012/credit · Supports guest paid reads

curl "https://xquik.com/api/v1/x/users/nasa/shadowban" \
  -H "x-api-key: xq_your_api_key_here" | jq

const response = await fetch("https://xquik.com/api/v1/x/users/nasa/shadowban", {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const body = await response.json();
if (!response.ok) throw new Error(JSON.stringify(body));

for (const [name, check] of Object.entries(body.checks)) {
  console.log(`${name}: ${check.verdict} (${check.reason})`);
}

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/users/nasa/shadowban",
    headers={"x-api-key": "xq_your_api_key_here"},
)
body = response.json()
if not response.ok:
    raise RuntimeError(body)

for name, check in body["checks"].items():
    print(f'{name}: {check["verdict"]} ({check["reason"]})')

Is an account shadowbanned on X?

Use GET /x/users/{id}/shadowban to run 4 checks on 1 account. Name the account by user ID, username, or profile URL.

account reads whether the account is active, protected, or suspended.
search looks for the account’s recent posts in X search. It uses from:username, sorted by Latest.
suggestion looks for the account among the accounts X suggests for its username.
replies opens the threads of up to 3 recent replies to other accounts. It finds where each reply shows.

Each check answers pass, fail, or unknown. It adds a reason and the evidence it read. The reply check answers pass or unknown, since X ranks replies for each viewer. A protected account gets the suggestion check only. A suspended account gets the account check only.

Path parameters

string

required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa. See path IDs.

Query parameters

string

Fields to keep in each row, comma-separated, such as id,text,author.username. Use dots for nested fields. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name returns 400 unknown_field with the valid names, before any read. The price stays the same.

string

Fields to drop from each row, comma-separated, such as entities,media. It takes the same names as fields. With fields, it drops from the kept fields.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

string | null

Username of the account. null for a suspended account named by user ID.

string | null

ID of the account. null for a suspended account named by username.

string

active, protected, or suspended.

object

The 4 checks. Each has verdict, reason, and evidence.

object

pass with active or protected, or fail with suspended. evidence.profileUrl opens the profile on X.

object

pass with listed or fail with missing. evidence holds query, searchUrl, recentPostIds, and foundPostIds.

object

pass with suggested or fail with not_suggested. evidence holds query and suggestedUsernames.

object

pass with in_thread, or unknown with more_replies or not_found. evidence.replies lists each reply with its placement, replyUrl, and parentUrl.

400 Invalid input

{ "error": "invalid_user_id" }

Send a user ID, a username, or a profile URL.

404 User not found

{ "error": "user_not_found", "message": "X user not found. Check the username." }

A user X does not know is free of charge.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

Related. Get user · Search tweets · Search autocomplete

{
  "username": "NASA",
  "userId": "11348282",
  "account": "active",
  "checkedAt": "2026-11-03T02:15:00.000Z",
  "overall": "clear",
  "checks": {
    "account": {
      "verdict": "pass",
      "reason": "active",
      "evidence": {
        "profileUrl": "https://x.com/NASA"
      }
    },
    "search": {
      "verdict": "pass",
      "reason": "listed",
      "evidence": {
        "query": "from:NASA",
        "searchUrl": "https://x.com/search?q=from%3ANASA&f=live",
        "recentPostIds": [
          "2103610284464316469"
        ],
        "foundPostIds": [
          "2103610284464316469"
        ]
      }
    },
    "suggestion": {
      "verdict": "pass",
      "reason": "suggested",
      "evidence": {
        "query": "NASA",
        "suggestedUsernames": [
          "NASA"
        ]
      }
    },
    "replies": {
      "verdict": "unknown",
      "reason": "more_replies",
      "evidence": {
        "replies": [
          {
            "replyId": "2103589735449141451",
            "replyUrl": "https://x.com/i/status/2103589735449141451",
            "parentId": "2102883223948628205",
            "parentUrl": "https://x.com/i/status/2102883223948628205",
            "placement": "more_replies"
          }
        ]
      }
    },
    "replyLock": {
      "verdict": "pass",
      "reason": "replies_show",
      "evidence": {
        "checkedReplies": 2,
        "shownReplies": 2
      }
    }
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "api_key_paused",
  "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter shadowban test API to check X accounts

curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id}/shadowban

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/users/{id}/shadowban"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "username": {},
  "userId": {},
  "account": "<string>",
  "checks": {
    "account": {},
    "search": {},
    "suggestion": {},
    "replies": {}
  }
}

Overview

X API

X write

Trends

Radar

Account

Activity

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter shadowban test API to check X accounts

Is an account shadowbanned on X?

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable

​Is an account shadowbanned on X?

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid input

​404 User not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

Is an account shadowbanned on X?

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable