API Documentation

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.upvote.net/v1/services

curl -X POST https://api.upvote.net/v1/orders \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "upvotes",
    "url": "https://reddit.com/r/example/comments/abc123/my_post",
    "quantity": 100
  }'

{
  "success": true,
  "data": {
    "order_id": "ord_a1b2c3d4e5",
    "service": "upvotes",
    "quantity": 100,
    "amount": 10.00,
    "status": "pending",
    "created_at": "2026-01-15T10:30:00Z"
  }
}

curl -X POST https://api.upvote.net/v1/orders \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "upvotes",
    "url": "https://reddit.com/r/startups/comments/xyz/my_post",
    "quantity": 250,
    "drip_feed": true,
    "drip_hours": 48
  }'

{
  "success": true,
  "data": {
    "order_id": "ord_f6g7h8i9j0",
    "service": "upvotes",
    "url": "https://reddit.com/r/startups/comments/xyz/my_post",
    "quantity": 250,
    "amount": 25.00,
    "status": "pending",
    "drip_feed": true,
    "drip_hours": 48,
    "estimated_completion": "2026-01-17T10:30:00Z",
    "created_at": "2026-01-15T10:30:00Z"
  }
}

curl https://api.upvote.net/v1/orders/ord_f6g7h8i9j0 \
  -H "x-api-key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "order_id": "ord_f6g7h8i9j0",
    "service": "upvotes",
    "quantity": 250,
    "delivered": 142,
    "amount": 25.00,
    "status": "processing",
    "drip_feed": true,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-16T03:15:00Z"
  }
}

{
  "success": true,
  "data": [
    {
      "id": "upvotes",
      "name": "Reddit Upvotes",
      "price_per_unit": 0.10,
      "min_quantity": 10,
      "max_quantity": 5000,
      "currency": "USD"
    },
    {
      "id": "downvotes",
      "name": "Reddit Downvotes",
      "price_per_unit": 0.12,
      "min_quantity": 10,
      "max_quantity": 2000,
      "currency": "USD"
    },
    {
      "id": "comments",
      "name": "Reddit Comments",
      "price_per_unit": 2.50,
      "min_quantity": 1,
      "max_quantity": 100,
      "currency": "USD"
    },
    {
      "id": "posts",
      "name": "Reddit Posts",
      "price_per_unit": 15.00,
      "min_quantity": 1,
      "max_quantity": 50,
      "currency": "USD"
    }
  ]
}

{
  "success": true,
  "data": {
    "balance": 487.50,
    "currency": "USD",
    "total_spent": 1512.50,
    "total_orders": 89,
    "tier": "pro"
  }
}

curl -X POST https://api.upvote.net/v1/orders/reddit-post \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "SaaS",
    "title": "We built an internal tool that cut our support tickets by 60%",
    "body": "Hey everyone, wanted to share what we learned...",
    "flair": "Case Study",
    "schedule_at": "2026-01-16T14:00:00Z"
  }'

{
  "success": true,
  "data": {
    "order_id": "ord_post_k1l2m3n4",
    "service": "reddit-post",
    "subreddit": "SaaS",
    "amount": 15.00,
    "status": "pending",
    "scheduled_at": "2026-01-16T14:00:00Z",
    "created_at": "2026-01-15T10:30:00Z"
  }
}

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.upvote.net/v1"

def create_order(service, url, quantity, **kwargs):
    response = requests.post(
        f"{BASE_URL}/orders",
        headers={
            "x-api-key": API_KEY,
            "Content-Type": "application/json"
        },
        json={
            "service": service,
            "url": url,
            "quantity": quantity,
            **kwargs
        }
    )
    return response.json()

# Example: Order 100 upvotes with drip feed
result = create_order(
    service="upvotes",
    url="https://reddit.com/r/example/comments/abc123/post",
    quantity=100,
    drip_feed=True,
    drip_hours=24
)
print(result)

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.upvote.net/v1";

async function createOrder(service, url, quantity, options = {}) {
  const response = await fetch(`${BASE_URL}/orders`, {
    method: "POST",
    headers: {
      "x-api-key": API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ service, url, quantity, ...options }),
  });
  return response.json();
}

// Example: Order 50 comments
const result = await createOrder(
  "comments",
  "https://reddit.com/r/example/comments/abc123/post",
  50,
  { content: "Great post, really insightful!" }
);
console.log(result);

<?php
$apiKey = "YOUR_API_KEY";
$baseUrl = "https://api.upvote.net/v1";

function createOrder($service, $url, $quantity, $options = []) {
    global $apiKey, $baseUrl;

    $data = array_merge([
        "service" => $service,
        "url" => $url,
        "quantity" => $quantity,
    ], $options);

    $ch = curl_init("$baseUrl/orders");
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            "x-api-key: $apiKey",
            "Content-Type: application/json",
        ],
        CURLOPT_POSTFIELDS => json_encode($data),
        CURLOPT_RETURNTRANSFER => true,
    ]);

    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

// Example: Order 200 upvotes
$result = createOrder("upvotes",
    "https://reddit.com/r/example/comments/abc123/post",
    200,
    ["drip_feed" => true]
);
print_r($result);

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Your account balance ($4.50) is insufficient for this order ($25.00). Please add funds.",
    "status": 402
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "status": 429,
    "retry_after": 45
  }
}