Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Connect

Vote on a Reddit post or comment

Cast, change, or clear the connected account's vote on a Reddit post or comment.

Reddit requires that votes be cast by humans. Reddit's API terms permit a client to proxy a human's action one-for-one, and prohibit a bot from deciding how to vote or from amplifying a human's vote. Call this endpoint only in direct response to an explicit action by the account owner. Automated or agent-decided voting is vote manipulation and puts API access at risk.

post/v1/accounts/{accountId}/reddit-vote

Path parameters

accountIdstring required

The ID of the Reddit account casting the vote

Request body

thingIdstring required

Reddit fullname of the target. Prefix "t3_" for a post and "t1_" for a comment. A bare id with no prefix is treated as a post ("t3_").

direction1 | 0 | -1 required

1 to upvote, -1 to downvote, 0 to clear an existing vote

Example request

{
  "thingId": "t3_abc123"
}

Response

Vote registered

successboolean