Upvote.Shop API Documentation

Simple REST API for sending Reddit upvotes, downvotes, and tracking orders.

Base URL

https://panel.upvote.shop/api

Authentication

Send a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

Get your token at: https://panel.upvote.shop/settings

1. Create Order

Create a new upvote, downvote, or TOP-ranking order.

POST /order/create

Required Fields

Field	Type	Description
link	string	Reddit post or comment URL
type	number	1 post upvote, 8 post downvote, 6 comment upvote, 7 comment downvote, 10 TOP ranking
vote	number	Total votes
after	number	Delay in minutes (0 = immediate)
speed	number	1-5 votes/min or 0.2–0.9 slow mode

TOP Ranking Rules

• Minimum 100 votes
• Speed must be 1

Optional Fields

"target": {
  "is_set": false,
  "position": 1
}

"custom_speed": {
  "enabled": true,
  "vote": 2,
  "hour": 24
}

If custom_speed.enabled is true (mosty used for drip-feed votes), target.is_set must be false.

Example Request

{
  "link": "post_or_comment_url",
  "type": 1,
  "vote": 5,
  "after": 0,
  "speed": 1,
  "target": { "is_set": false, "position": 1 },
  "custom_speed": { "enabled": true, "vote": 2, "hour": 24 }
}

Success Response

{
  "code": 1,
  "message": "Success",
  "order_id": "3333"
}

Error Response

{
  "code": -1,
  "message": "Error message"
}

2. Get Order Details

GET /order/:id

Example

{
  "code": 1,
  "status": "processing",
  "vote": 5,
  "type": 1,
  "rank": 5,
  "target": { "is_set": true, "position": 1 },
  "subreddit": "ask",
  "author": "reddit_user",
  "created": 1706583019193
}

Error

{ "code": -1, "message": "Message Error" }

3. Check Balance

GET /check-balance

Example

{
  "balance": 10.4,
  "email": "your_email@"
}