How to Use Upvote.Shop API

Here is a quick guide showing you how to use our Upvote.Shop API for sending upvotes from our system to your targeted posts/comments via your own app or software.

Get your API Access Token via our Panel: https://panel.upvote.shop/settings

Upvote.Shop API Information

Bearer Authentication is required for accessing this endpoint. Authentication is performed via JWT token in the Authorization header.

Headers:

Key	Value
Content-Type	application/json
Authorization	Authorization: JWT token. (Type: Bearer Token, Required: Yes)

1. Create Order

Create a new order.

Endpoint	POST https://panel.upvote.shop/api/order/create
Request Headers	Authorization: JWT token. (Type: Bearer Token, Required: Yes)
Responses	Code 200: Successful response Code 400: Error
link	Type: String (Reddit URL)
type	Type: Number (1 is post upvote; 8 is post downvote; 6 is comment upvote; 7 is comment downvote; 10 is TOP targeted ranking). Note: For the TOP Targeted Ranking, min order is 100, and set speed to 1.
vote	Type: Number (greater than 0, less than Max Upvote)
after	Type: Number (run after x minutes, 0: immediately, greater than 0: delay time)
speed	Type: Number (from 1 to 5 votes/min). Note: 0.2 → 0.9 is the mega slow mode (0.2 = 1 vote every 5 minutes).
target	Type: Object. Position: From 1 to 20.

Example:

{
  "link": "post_or_comment_url",
  "type": 1,
  "vote": 5,
  "after": 0,
  "speed": 1,
  "target": {
    "is_set": true,
    "position": 1
  }
}

Responses:

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

2. Retrieve Order Details

Retrieve details of a specific order by its ID.

Endpoint	GET https://panel.upvote.shop/api/order/:id
Request Parameters	ID: The unique identifier of the order. (Type: String, Required: Yes)
Request Headers	Authorization: JWT token. (Type: Bearer Token, Required: Yes)
Responses	Code 200: Successful response
Status value	“processing”, “canceled”, “pending” , “success”
Code 400	Error response

Example:

{
  "code": 1,
  "status": "processing",
  "after": 0,
  "vote": 5,
  "type": 1,
  "start_votes": 1,
  "last_votes": 0,
  "order_error_message": "Error message",
  "id": "123456",
  "target": {
    "is_set": true,
    "position": 1,
    "max_hours": 2
  },
  "subreddit": "ask",
  "author": "reddit_user",
  "rank": 5,
  "random_mode": false,
  "vote_min": 1,
  "vote_max": 5,
  "created": 1706583019193,
  "finish_time": 1706583053232
}

Responses:

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

3. Check Balance

Check the user’s balance.

Endpoint	GET: https://panel.upvote.shop/api/check-balance
Request Headers	Authorization: JWT token. (Type: Bearer Token, Required: Yes)
Responses	Code 200: Successful response Code 401: Token Invalid

Example:

GET /api/check-balance
Authorization: Bearer YOUR_JWT_TOKEN

Responses:

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