Vote in Poll
POST
/tw-v2/interaction/vote-poll1 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| auth | string | required | Authentication token (auth_token cookie value) of the X account that votes |
| tweet | string | required | ID of the post with the poll |
| choicenumberrequired | number | required | Option to vote for, an integer from 1 to 4 as numbered on x.com |
| proxystringoptional | string | optional | Optional 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.