v3

latestOpenAPI 3.0.32026-08-02415689.9 KB

Verification

Check Shadowban

Checks whether a Twitter/X account is restricted in visibility. Runs two independent measurements: search_suggestion_ban — whether the account appears in search suggestions when its exact handle is typed — and search_ban — whether its posts are returned by search. Each check reports clean, banned or unknown; unknown carries a reason and means the measurement could not be made, never that the account is restricted. is_shadowbanned is true only when at least one check found an actual restriction. Profile flags (protected, possibly_sensitive) are reported separately and never count as a shadowban. Results are cached for an hour — see checked_at for the age of the data.

get/check-shadowban

Query parameters

usernamestring required

Twitter/X handle (without @).

Response

checked_atstring

When the measurement actually happened. Results are cached, so this can be older than the request.

is_shadowbannedboolean

true when at least one check found a restriction. Checks that are unknown never count.

user_idstring

usernamestring

Example response

{
  "account": {
    "statuses_count": 41230
  },
  "checked_at": "2026-08-01T10:00:00Z",
  "checks": {
    "search_ban": {
      "reason": "no_tweets",
      "status": "clean",
      "tweets_found": 18
    },
    "search_suggestion_ban": {
      "reason": "no_tweets",
      "status": "clean",
      "tweets_found": 18
    }
  },
  "user_id": "44196397",
  "username": "elonmusk"
}