Sign in
post_votes

Get a list of post votes

Changed on

Returns a paginated list of post votes based on search criteria.

get/post_votes.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/post_votes.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Query parameters

pageinteger

The page number for pagination

limitinteger

The number of post votes to retrieve per page

search[post_id]integer

Filter by post ID

search[user_name]string

Filter by voter username

search[user_id]integer

Filter by voter user ID

search[post_creator_id]integer

Filter by post uploader ID

search[post_creator_name]string

Filter by post uploader username

search[timeframe]integer

Filter by votes within the last N days

search[score]1 | -1

The vote score (1 for upvote, -1 for downvote)

Filter by vote score (1 or -1)

search[user_ip_addr]string

Filter by voter IP address (admin only)

search[duplicates_only]boolean

Show only duplicate IP votes (admin only)

search[order]string

Sort order (admin only, supports ip_addr)

Response

A list of post votes

idinteger required

The unique ID of the vote

post_idinteger required

The ID of the voted post

user_idinteger required

The ID of the voting user

scoreinteger required

The vote score (1, 0, or -1)

created_atstring date-time required

When the vote was cast

updated_atstring date-time required

When the vote was last updated

Changes