API Documentation
Automate Reddit upvotes, downvotes, and custom comments. REST-style JSON endpoints with API key authentication.
Integrate Reddit upvotes, downvotes, and custom comments into your workflow. All requests use JSON over HTTPS and authenticate with an API key in the X-API-Key header.
Get your API key
Sign in to the dashboard to generate or rotate your API key. Keep it secret — include it in every request as X-API-Key.
Submit upvote order
Submit an upvote or downvote order for a Reddit post or comment.
Endpoint
https://api.buyupvotes.io/upvote_order/submit/Request body
| Parameter | Type | Required | Description |
|---|---|---|---|
| link | str | yes | The URL of the Reddit post or comment to receive upvotes/downvotes |
| quantity | int | yes | Number of upvotes/downvotes to deliver (between 5 and 100) |
| service | int | yes | Service type
|
| speed | string | yes | Delivery speed
|
Validations
- link: Must be a Reddit link copied on desktop (no mobile links)
- quantity: Integer between 5 and 100
- service: Integer — one of 1, 2, 3, or 4
- speed: One of slowest, slow, normal, fast
Example request
import requests
url = 'https://api.buyupvotes.io/upvote_order/submit/'
headers = {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here',
}
data = {
'link': '<valid Reddit link>',
'quantity': 5,
'service': 1,
'speed': 'slowest',
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
print('Order submitted:', response.json())
else:
print('Error:', response.json().get('message'))Successful response
{
"message": "Order submitted successfully",
"order_number": "1891780"
}Upvote order status
Retrieve the status of a submitted upvote/downvote order.
Endpoint
https://api.buyupvotes.io/upvote_order/status/Request body
| Parameter | Type | Required | Description |
|---|---|---|---|
| order_number | str | yes | The order number of the upvote order |
Example request
import requests
url = 'https://api.buyupvotes.io/upvote_order/status/'
headers = {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here',
}
data = {
'order_number': '1891780',
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
print('Order status:', response.json())
else:
print('Error:', response.json().get('message'))Successful response
{
"order_number": "1891780",
"service": "Post upvotes",
"status": "Completed",
"vote_quantity": 5,
"votes_delivered": 5
}Submit comment order
Submit an order to post a comment on a Reddit post or reply to another comment.
Endpoint
https://api.buyupvotes.io/comment_order/submit/Request body
| Parameter | Type | Required | Description |
|---|---|---|---|
| link | str | yes | Reddit post or comment URL where the comment should be posted |
| content | str | yes | Comment text
|
Validations
- link: Must be a Reddit link copied on desktop (no mobile links)
- content: Required
Example request
import requests
url = 'https://api.buyupvotes.io/comment_order/submit/'
headers = {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here',
}
data = {
'link': '<valid Reddit link>',
'content': 'The text of the comment',
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
print('Comment order submitted:', response.json())
else:
print('Error:', response.json().get('message'))Successful response
{
"message": "Comment order submitted successfully",
"order_number": "1891780"
}
Comment order status
Retrieve the status of a submitted comment order.
Endpoint
https://api.buyupvotes.io/comment_order/status/Request body
The order number of the comment order
Example request
Successful response