Skip to content

Twitter API error 403 Forbidden

A Twitter (X) API error 403 means the server understood your request but refuses to carry it out. With a 401 the credentials weren't accepted. With a 403 they were read and accepted, but they don't permit this action.

Look up an X profile now, no signupNo developer tier needed.
Twitter api error 403: a traveller at a closed garden gate reading a small sign while a gatekeeper shakes their head.

Common causes

The endpoint isn't part of your access tier. The app or account is suspended or limited. The token is missing a permission the endpoint needs, such as write access. Or the request targets something you can't see, like a protected account.

A checklist

Start with the error body, because it usually names the reason. Check that your tier includes the endpoint, and confirm in the developer portal that the app is active. Look at the token scopes, and regenerate the token if you changed permissions. If all you need is public data, a read-only route may be enough. See does Twitter have an API, the X API key guide and Twitter API v2.

A read-only route

If you only need posts and profiles, a hosted API means you don't have to deal with tiers at all. ChatterAPI reads public X data with one key and is independent of X.

A normal response, for comparison

A profile lookup. This is a typical read call, and it doesn't depend on an X developer tier.

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

What is the difference between 401 and 403?
A 401 means your credentials weren't accepted. A 403 means they were accepted but don't allow this request.
Can a 403 mean my app is suspended?
Yes. The developer portal shows the app's status.
Does a protected account return 403?
You can't read a protected account's posts without approval, so the request gets refused.

Guides

More errors

Try it with one key

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