Skip to content

Vote in Poll

POST/tw-v2/interaction/vote-poll

1 API unit per call · How billing works

Description

Vote in a poll on a post.

Usage notes

tweetId is the post that holds the poll. choice is the number of the option, from 1 to 4, in the order x.com shows the options. A post without a poll, a poll that has ended, or a choice the poll doesn't have returns 400; a post that doesn't exist returns 404. If the vote can't be confirmed, the request fails with 502 and is not billed.

A request costs one API unit. 400, 401, 403, 409, 422, 429 and 5xx errors are free; a 404 is billed.

Request Body

ParameterDescription
authTokenstringrequiredAuthentication token (auth_token cookie value) of the X account that votes
tweetIdstringrequiredID of the post with the poll
choicenumberrequiredOption to vote for, an integer from 1 to 4 as numbered on x.com
proxystringoptionalOptional proxy in format 'host:port@user:pass'

Code Examples

const body = {
  authToken: 'YOUR_AUTH_TOKEN',
  tweetId: '1234567890',
  choice: 2
};

const response = await fetch('https://api.tweetapi.com/tw-v2/interaction/vote-poll', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

Synthetic example:

200
{
  "data": {
    "id": "1234567890",
    "action": "vote_poll",
    "timestamp": "2026-11-03T12:00:00.000Z",
    "success": true,
    "metadata": {
      "tweet_id": "1234567890",
      "choice": 2
    }
  }
}

Errors

Errors return { statusCode, message } with a non-2xx HTTP status.

400
{
  "statusCode": 400,
  "message": "Request validation failed"
}

TweetAPI is a third-party API and is not affiliated with X Corp.