Account status for many handles

Parameters

• usernamesquery · string (comma-separated) · required

  Handles separated by commas, with or without @. At most 500.

Example request

curl 'https://api.twittrapi.com/user/usernames/status?usernames=jack,XDevelopers' \
  --header 'X-API-KEY: YOUR_API_KEY'

import httpx

# No SDK method for this endpoint yet, so this is a plain HTTP call.
resp = httpx.get(
    "https://api.twittrapi.com/user/usernames/status",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    params={
        "usernames": "jack,XDevelopers",
    },
    timeout=60,
)
data = resp.json()

import { TwittrAPI } from "twittrapi";

const client = new TwittrAPI({ apiKey: process.env.TWITTRAPI_API_KEY });
// No wrapper method for this endpoint yet; client.get() sends the same authenticated GET.
const data = await client.get({
  path: "/user/usernames/status",
  query: {
    usernames: "jack,XDevelopers",
  },
});

curl 'https://twitter-aio.p.rapidapi.com/user/usernames/status?usernames=jack,XDevelopers' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \
  --header 'x-rapidapi-host: twitter-aio.p.rapidapi.com'

Base URL https://api.twittrapi.com, key in the X-API-KEY header. Python and Node.js use the official SDKs.

Response

Built by the API: {"usernamesStatus": {"jack": "active", ...}}. Values: active, suspended, protected, not-found, or error when X could not be asked. For each error there is also an entry in errors: [{"username": "...", "error": "upstream_error", "message": "..."}]; errors is left out when there are none.

Simple format (?format=simple or X-Response-Format: simple): Unchanged inside {data: ...}: {usernamesStatus, errors} is already small, so the simple format only adds the envelope. Schema.

{
  "usernamesStatus": {
    "XDevelopers": "active",
    "jack": "active"
  }
}

{
  "data": {
    "usernamesStatus": {
      "XDevelopers": "active",
      "jack": "active"
    }
  }
}

In the raw format, field names and nesting come from X and can change without notice. See Response format; the simple format keeps a fixed schema.

Errors

• 400usernames is missing or has more than 500 entries.

Errors every endpoint can return (401, 402, 403, 404, 408, 409, 429, 5xx), and which of them are charged, are on the Errors page. Calls that fail with 400, 408, 409 or a 5xx error are refunded.