Overview

Upvotes or downvotes a Reddit post by its ID. This endpoint uses Reddit's GraphQL API to cast your vote.

Inputs

| Field | Type | Required | Description | |-------|------|----------|-------------| | postid | string | Yes | The Reddit post ID (e.g., t31uyaav5) | | direction | select | Yes | Vote direction: UP (default) or DOWN |

Direction options

UP - Upvote the post (default)
DOWN - Downvote the post

Response

Returns the GraphQL mutation response from Reddit:

{
  "data": {
    "updatePostVoteState": {
      "post": {
        "id": "t3_xxxxx",
        "voteState": "UPVOTE"
      }
    }
  }
}

Auth & browser

Requires authentication: Yes (uses browser session cookies)
useContext: Enabled - shares cookies with authenticated Reddit session
You must be logged into Reddit in the browser context

Examples

Upvote a post:

{
  "post_id": "t3_1uyaav5",
  "direction": "UP"
}

Downvote a post:

{
  "post_id": "t3_1uyaav5",
  "direction": "DOWN"
}

Notes

Post ID format: Use the full Reddit post ID starting with t3_ (found in URLs like /r/subreddit/comments/xxxxx/)
Rate limiting: Reddit enforces vote rate limits
Double voting: Calling the same vote direction twice has no additional effect
Changing votes: Call again with the opposite direction to change your vote
Permissions: You can only vote on posts you can see (no voting on private/quarantined without access)