Developers

API Documentation

Automate Reddit upvotes, downvotes, and custom comments. REST-style JSON endpoints with API key authentication.

New to the API? API landing page — overview, pricing, code examples and competitive comparison. Running campaigns for multiple clients? Built for agency use — bulk API, volume discounts and white-label delivery.

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.

Endpoints overview

1. Submit upvote order
2. Upvote order status
3. Submit comment order
4. Comment order status

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.

Open dashboard API

Submit upvote order

Submit an upvote or downvote order for a Reddit post or comment.

Endpoint

POSThttps://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 1: Post upvotes 2: Post downvotes 3: Comment upvotes 4: Comment downvotes
speed	string	yes	Delivery speed slowest: 1 vote / 6 minutes slow: 1 vote / 5 minutes normal: 2 votes / minute fast: 3 votes / minute

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

POSThttps://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

POSThttps://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 Links: [link text](https://yourlink.com) New line: include [newline] in the text

Parameter

Type

Required

Description

link

str

yes

Reddit post or comment URL where the comment should be posted

content

str

yes

Comment text

Links: [link text](https://yourlink.com)
New line: include [newline] in the 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

POSThttps://api.buyupvotes.io/comment_order/status/

Request body

Parameter	Type	Required	Description
order_number	str	yes	The order number of the comment order

Example request

import requests

url = 'https://api.buyupvotes.io/comment_order/status/'

headers = {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here',
}

data = {
    'order_number': '1891783',
}

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

if response.status_code == 200:
    print('Comment order status:', response.json())
else:
    print('Error:', response.json().get('message'))

Successful response

{
    "order_number": "1891783",
    "status": "Completed"
}

Developers

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.

Endpoints overview

1. Submit upvote order
2. Upvote order status
3. Submit comment order
4. Comment order status

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.

Open dashboard API

Submit upvote order

Submit an upvote or downvote order for a Reddit post or comment.

Endpoint

POSThttps://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 1: Post upvotes 2: Post downvotes 3: Comment upvotes 4: Comment downvotes
speed	string	yes	Delivery speed slowest: 1 vote / 6 minutes slow: 1 vote / 5 minutes normal: 2 votes / minute fast: 3 votes / minute

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

POSThttps://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

POSThttps://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 Links: [link text](https://yourlink.com) New line: include [newline] in the text

Parameter

Type

Required

Description

link

str

yes

Reddit post or comment URL where the comment should be posted

content

str

yes

Comment text

Links: [link text](https://yourlink.com)
New line: include [newline] in the 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

POSThttps://api.buyupvotes.io/comment_order/status/

Request body

Parameter	Type	Required	Description
order_number	str	yes	The order number of the comment order

Example request

import requests

url = 'https://api.buyupvotes.io/comment_order/status/'

headers = {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here',
}

data = {
    'order_number': '1891783',
}

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

if response.status_code == 200:
    print('Comment order status:', response.json())
else:
    print('Error:', response.json().get('message'))

Successful response

{
    "order_number": "1891783",
    "status": "Completed"
}