Upvote.Shop API Documentation

Simple REST API for sending Reddit upvotes and managing orders from your own app or SaaS.

Base URL

https://panel.upvote.shop/api

Authentication

Use 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 Reddit upvote or downvote 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 to send
after	number	Delay in minutes (0 = immediate)
speed	number	1-5 votes per minute (0.2–0.9 for slow mode)

TOP Ranking Rules

• Minimum 100 votes
• Speed must be 1

Optional Fields

target

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

custom_speed

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

If custom_speed.enabled is true, then 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

Retrieve status, ranking, and metadata for an order.

GET /order/:id

Example Response

{ "code": 1, "status": "processing", "after": 0, "vote": 5, "type": 1, "start_votes": 1, "last_votes": 0, "order_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 }

Error

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

3. Check Balance

Check account balance and email.

GET /check-balance

Example Response

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

Upvote.Shop API Documentation

Simple REST API for sending Reddit upvotes and managing orders.

Base URL

https://panel.upvote.shop/api

Authentication

Use 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 Reddit upvote/downvote order.

Endpoint

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 (0.2–0.9 for slow mode)

TOP Ranking Rules

• Minimum 100 votes
• Speed must be 1

Optional Fields

target

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

custom_speed

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

If custom_speed.enabled = true, then 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

Retrieve progress, ranking, and metadata of an order.

Endpoint

GET /order/:id

Example Response

{
  "code": 1,
  "status": "processing",
  "after": 0,
  "vote": 5,
  "type": 1,
  "start_votes": 1,
  "last_votes": 0,
  "order_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
}

Error

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

3. Check Balance

Get account balance and account email.

Endpoint

GET /check-balance

Example

{
  "balance": 10.4,
  "email": "[email protected]"
}