Skip to content

Twitter status API: is X working?

Checking the Twitter status API tells you whether the X API is answering, and whether a failure comes from X, your access tier or your own code. X publishes status information for its API. The error code tells you the rest.

Twitter status api: a weather-station keeper checking a barometer and a row of small flags on a windy hill.

How to check

Check X's developer status information, then make one plain request with your token. If a simple request works, the service is up. A 429 means you hit a rate limit, a 401 means your credentials were rejected, a 403 means your tier doesn't allow the request, and a 5xx means the problem is on the server.

For the permission case, read Twitter API error 403. For limits, read X rate limit exceeded.

A second path for reading

If you only read public data, a hosted API has its own uptime, separate from X access tiers. See does Twitter have an API and the ChatterAPI status page.

A normal response, for comparison

A profile lookup, a typical read call.

curl "https://api.chatterapi.com/v1/x/users/levelsio" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": {
    "id": "1577241403",
    "handle": "levelsio",
    "name": "@levelsio",
    "bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
    "followers": 974707,
    "following": 3276,
    "tweets": 181450,
    "verified": false,
    "blueVerified": true,
    "canDm": false,
    "protected": false,
    "location": "📕My book $5K/m 👉",
    "url": "https://readMAKE.com",
    "avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
    "createdAt": "2013-07-08T09:31:59.000Z",
    "profileUrl": "https://x.com/levelsio",
    "bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
    "likesGiven": 185852,
    "mediaCount": 19829,
    "pinnedTweetIds": [
      "2109949585737052316"
    ]
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.

Free tools

Questions

Is the Twitter API down?
Make one plain request. If it works, the service is up. If it fails, read the error code.
What does a 403 mean?
X understood your request, but your access tier or token doesn't allow it. See Twitter API error 403.
Does a hosted API depend on my X tier?
No. It has its own access and its own status.

Guides

More errors

Try it with one key

Try it free for 7 days with 1,000 credits.