🔑 API DETAILS
API URL
https://empire-upvotes.com/api/v1
API KEY

Your API Key (available in your dashboard)

HTTP METHOD
POST
RESPONSE FORMAT
JSON
CONTENT TYPE
application/json
RATE LIMIT
100 req/min
🛒 PLACE NEW ORDER
Parameter Type Required Description
key string Yes Your API key
action string Yes "add"
service integer Yes Service ID (use "services" action to get list)
link string Yes Reddit post or comment URL
quantity integer Yes Number of upvotes (check min/max in service list)
interval string|integer Optional Delay between upvotes in seconds.
Values: 30, 60, 120, 240 or "random"
⚡ Default: 30
geo string Optional Geographic location of accounts.
Values: "USA", "EU", "CA"
⚡ Default: "USA"
cURL Example 
curl -X POST "https://empire-upvotes.com/api/v1" \
                                   -H "Content-Type: application/json" \
                                   -d '{
                                     "key": "YOUR_API_KEY",
                                     "action": "add",
                                     "service": 1,
                                     "link": "https://www.reddit.com/r/example/comments/abc123/your_post/",
                                     "quantity": 100
                                   }'
Python Example 
import requests

                                 url = "https://empire-upvotes.com/api/v1"

                                 payload = {
                                     "key": "YOUR_API_KEY",
                                     "action": "add",
                                     "service": 1,
                                     "link": "https://www.reddit.com/r/example/comments/abc123/your_post/",
                                     "quantity": 100,
                                     "interval": 30,       # Optional: 30, 60, 120, 240, or "random"
                                     "geo": "USA"          # Optional: "USA", "EU", or "CA"
                                 }

                                 response = requests.post(url, json=payload)
                                 data = response.json()

                                 if data.get("status") == "success":
                                     print(f"Order created! Order ID: {data['order']}")
                                 else:
                                     print(f"Error: {data.get('error')}")
Java Example 
import java.net.http.*;
                                 import java.net.URI;

                                 public class EmpireUpvotesAPI {
                                     public static void main(String[] args) throws Exception {
                                         String url = "https://empire-upvotes.com/api/v1";

                                         String json = """
                                             {
                                                 "key": "YOUR_API_KEY",
                                                 "action": "add",
                                                 "service": 1,
                                                 "link": "https://www.reddit.com/r/example/comments/abc123/your_post/",
                                                 "quantity": 100,
                                                 "interval": 30,
                                                 "geo": "USA"
                                             }
                                             """;

                                         HttpClient client = HttpClient.newHttpClient();
                                         HttpRequest request = HttpRequest.newBuilder()
                                             .uri(URI.create(url))
                                             .header("Content-Type", "application/json")
                                             .POST(HttpRequest.BodyPublishers.ofString(json))
                                             .build();

                                         HttpResponse<String> response = client.send(request,
                                             HttpResponse.BodyHandlers.ofString());

                                         System.out.println(response.body());
                                     }
                                 }
PHP Example 
<?php
                                 $url = "https://empire-upvotes.com/api/v1";

                                 $data = [
                                     "key" => "YOUR_API_KEY",
                                     "action" => "add",
                                     "service" => 1,
                                     "link" => "https://www.reddit.com/r/example/comments/abc123/your_post/",
                                     "quantity" => 100,
                                     "interval" => 30,       // Optional: 30, 60, 120, 240, or "random"
                                     "geo" => "USA"          // Optional: "USA", "EU", or "CA"
                                 ];

                                 $ch = curl_init($url);
                                 curl_setopt($ch, CURLOPT_POST, true);
                                 curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
                                 curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
                                 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

                                 $response = curl_exec($ch);
                                 curl_close($ch);

                                 $result = json_decode($response, true);

                                 if ($result['status'] === 'success') {
                                     echo "Order created! Order ID: " . $result['order'];
                                 } else {
                                     echo "Error: " . $result['error'];
                                 }
                                 ?>
Success Response 
{
                                     "status": "success",
                                     "order": 109127
                                 }
Error Response 
{
                                     "error": "Insufficient balance"
                                 }
📊 ORDER STATUS
Parameter Type Required Description
key string Yes Your API key
action string Yes "status"
order integer Yes Order ID
cURL Example 
curl -X POST "https://empire-upvotes.com/api/v1" \
                                   -H "Content-Type: application/json" \
                                   -d '{
                                     "key": "YOUR_API_KEY",
                                     "action": "status",
                                     "order": 109127
                                   }'
Python Example 
import requests

                                 url = "https://empire-upvotes.com/api/v1"

                                 payload = {
                                     "key": "YOUR_API_KEY",
                                     "action": "status",
                                     "order": 109127
                                 }

                                 response = requests.post(url, json=payload)
                                 data = response.json()

                                 print(f"Status: {data['status']}")
                                 print(f"Progress: {data['progress']}/{data['quantity']}")
Java Example 
String json = """
                                     {
                                         "key": "YOUR_API_KEY",
                                         "action": "status",
                                         "order": 109127
                                     }
                                     """;

                                 // Use same HttpClient setup as in "add" example
Success Response 
{
                                     "order": 109127,
                                     "link": "https://www.reddit.com/r/example/comments/abc123/",
                                     "status": "PROGRESS",
                                     "quantity": 100,
                                     "progress": 67,
                                     "interval": "random",
                                     "geo": "USA",
                                     "start_score": 4,
                                     "price": "100",
                                     "currency": "points"
                                 }
PROCESSING Waiting to start PROGRESS In progress COMPLETED Finished REFUNDED Cancelled & refunded
📋 MULTIPLE ORDER STATUS
Parameter Type Required Description
key string Yes Your API key
action string Yes "orders"
orders array Yes Array of order IDs, e.g. [109127, 109128, 109129]
cURL Example 
curl -X POST "https://empire-upvotes.com/api/v1" \
                                   -H "Content-Type: application/json" \
                                   -d '{
                                     "key": "YOUR_API_KEY",
                                     "action": "orders",
                                     "orders": [109127, 109128, 109129]
                                   }'
Python Example 
import requests

                                 url = "https://empire-upvotes.com/api/v1"

                                 payload = {
                                     "key": "YOUR_API_KEY",
                                     "action": "orders",
                                     "orders": [109127, 109128, 109129]
                                 }

                                 response = requests.post(url, json=payload)
                                 orders = response.json()

                                 for order in orders:
                                     print(f"Order #{order['order']}: {order['status']} - {order['progress']}/{order['quantity']}")
Success Response 
[
                                     {
                                         "order": 109127,
                                         "status": "COMPLETED",
                                         "quantity": 100,
                                         "progress": 100
                                     },
                                     {
                                         "order": 109128,
                                         "status": "PROGRESS",
                                         "quantity": 50,
                                         "progress": 32
                                     }
                                 ]
📦 SERVICE LIST
Parameter Type Required Description
key string Yes Your API key
action string Yes "services"
cURL Example 
curl -X POST "https://empire-upvotes.com/api/v1" \
                                   -H "Content-Type: application/json" \
                                   -d '{"key": "YOUR_API_KEY", "action": "services"}'
Python Example 
import requests

                                 url = "https://empire-upvotes.com/api/v1"

                                 payload = {
                                     "key": "YOUR_API_KEY",
                                     "action": "services"
                                 }

                                 response = requests.post(url, json=payload)
                                 services = response.json()

                                 for service in services:
                                     print(f"ID: {service['service']} | {service['name']} | Min: {service['min']} | Max: {service['max']}")
Success Response 
[
                                     {
                                         "service": 1,
                                         "name": "🚀 Post Upvotes",
                                         "category": "Reddit",
                                         "min": 50,
                                         "max": 5000,
                                         "rate": 1
                                     },
                                     {
                                         "service": 2,
                                         "name": "🚀 Comment Upvotes",
                                         "category": "Reddit",
                                         "min": 50,
                                         "max": 5000,
                                         "rate": 1
                                     }
                                 ]
💰 USER BALANCE
Parameter Type Required Description
key string Yes Your API key
action string Yes "balance"
cURL Example 
curl -X POST "https://empire-upvotes.com/api/v1" \
                                   -H "Content-Type: application/json" \
                                   -d '{"key": "YOUR_API_KEY", "action": "balance"}'
Python Example 
import requests

                                 url = "https://empire-upvotes.com/api/v1"

                                 payload = {
                                     "key": "YOUR_API_KEY",
                                     "action": "balance"
                                 }

                                 response = requests.post(url, json=payload)
                                 data = response.json()

                                 print(f"Balance: {data['balance']} {data['currency']}")
Success Response 
{
                                     "status": "success",
                                     "balance": "1500.00",
                                     "currency": "points"
                                 }