X (Twitter) Integration Terminal Errors

Authentication Errors

401 Unauthorized

HTTP 401 Unauthorized
{
  "title": "Unauthorized",
  "type": "about:blank",
  "status": 401,
  "detail": "Unauthorized"
}

403 Forbidden

HTTP 403 Forbidden
{
  "client_id": "123456789",
  "required_enrollment": "Appropriate",
  "reason": "client-not-enrolled",
  "registration_url": "https://developer.twitter.com/en/portal/dashboard"
}

API Errors

429 Too Many Requests

HTTP 429 Too Many Requests
{
  "title": "Too Many Requests",
  "type": "about:blank",
  "status": 429,
  "detail": "Too Many Requests"
}
x-rate-limit-limit: 300
x-rate-limit-remaining: 0
x-rate-limit-reset: 1640995200

400 Bad Request

HTTP 400 Bad Request
{
  "errors": [
    {
      "parameters": {
        "query": [
          ""
        ]
      },
      "message": "The query parameter is required"
    }
  ],
  "title": "Invalid Request",
  "detail": "One or more parameters to your request was invalid",
  "type": "https://api.twitter.com/2/problems/invalid-request"
}

422 Unprocessable Entity

HTTP 422 Unprocessable Entity
{
  "errors": [
    {
      "parameters": {
        "text": [
          "This Tweet is a duplicate and cannot be posted."
        ]
      },
      "message": "This Tweet is a duplicate and cannot be posted."
    }
  ],
  "title": "Unprocessable Entity",
  "detail": "Validation failed: Tweet is a duplicate",
  "type": "https://api.twitter.com/2/problems/validation-failed"
}

SDK-Specific Errors

Python SDK: tweepy.errors.Unauthorized

Traceback (most recent call last):
  File "twitter_script.py", line 12, in <module>
    client = tweepy.Client(bearer_token='invalid_token')
  File "/usr/local/lib/python3.9/site-packages/tweepy/client.py", line 123, in __init__
    raise Unauthorized(response)
tweepy.errors.Unauthorized: 401 Unauthorized
Unauthorized

Python SDK: tweepy.errors.TooManyRequests

Traceback (most recent call last):
  File "twitter_script.py", line 18, in <module>
    tweets = client.search_recent_tweets(query="python")
  File "/usr/local/lib/python3.9/site-packages/tweepy/client.py", line 987, in search_recent_tweets
    raise TooManyRequests(response)
tweepy.errors.TooManyRequests: 429 Too Many Requests
Too Many Requests

Node.js SDK: TwitterApiError

TwitterApiError: Request failed with code 401
    at TwitterApiV2.request (/node_modules/twitter-api-v2/dist/client.v2.js:456:19)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
    at async main (/app/index.js:23:18)
{
  code: 401,
  data: {
    title: 'Unauthorized',
    type: 'about:blank',
    status: 401,
    detail: 'Unauthorized'
  },
  headers: {
    'content-type': 'application/json; charset=utf-8',
    'x-rate-limit-limit': '300',
    'x-rate-limit-remaining': '299',
    'x-rate-limit-reset': '1640995200'
  }
}

Field-Specific Errors

Invalid user ID

HTTP 400 Bad Request
{
  "errors": [
    {
      "parameters": {
        "user_id": [
          "invalid_user_id"
        ]
      },
      "message": "The user id is not valid"
    }
  ],
  "title": "Invalid Request",
  "detail": "One or more parameters to your request was invalid",
  "type": "https://api.twitter.com/2/problems/invalid-request"
}

Duplicate Tweet

HTTP 400 Bad Request
{
  "errors": [
    {
      "parameters": {
        "text": [
          "This Tweet is a duplicate and cannot be posted."
        ]
      },
      "message": "This Tweet is a duplicate and cannot be posted."
    }
  ],
  "title": "Invalid Request",
  "detail": "One or more parameters to your request was invalid",
  "type": "https://api.twitter.com/2/problems/invalid-request"
}

Webhook Errors

Invalid webhook URL

HTTP 400 Bad Request
{
  "errors": [
    {
      "message": "Invalid webhook URL. Webhook URLs must use https."
    }
  ],
  "title": "Invalid Request",
  "detail": "One or more parameters to your request was invalid",
  "type": "https://api.twitter.com/2/problems/invalid-request"
}

Connection Errors

ECONNRESET

Error: read ECONNRESET
    at TLSWrap.onStreamRead (internal/stream_base_commons.js:209:20)

Timeout

Error: Timeout of 30000ms exceeded
    at createError (/node_modules/axios/lib/core/createError.js:16:15)
    at Timeout.handleTimeout [as _onTimeout] (/node_modules/axios/lib/adapters/http.js:280:16)
    at listOnTimeout (timers.js:557:17)
    at processTimers (timers.js:500:7)