API Endpoint Documentation
Complete reference for all API endpoints with detailed examples across multiple programming languages.
Authentication
Important API Access Requirements:
- Users must ensure they are not blacklisted
- If banned, users can contact the site administrator
- API access must be enabled for the account
- All API permissions should be properly configured
Warning: Make sure to keep your API key secure. Do not share it with anyone. If you think your API key has been compromised, you can regenerate it from the Account Settings page.
Base URL
https://domain.com/api/v2
Request Format Options
Authentication Examples
curl --location 'https://domain.com/api/v2' \
--form 'action="balance"' \
--form 'key="YOUR_API_KEY"'
POST/api/v2
Get Account Balance (balance)
Get the account balance.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "balance" | Yes |
Get Account Balance Example
curl --location 'https://domain.com/api/v2' \
--form 'action="balance"' \
--form 'key="YOUR_API_KEY"'
Response
{
"balance": "128.60633",
"currency": "EUR"
}
POST/api/v2
Get Services List (services)
Get the list of services available in the platform.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "services" | Yes |
Get Service List Example
curl --location 'https://domain.com/api/v2' \
--form 'action="services"' \
--form 'key="YOUR_API_KEY"'
Response
[
{
"service": 1,
"name": "Followers",
"category": "First Category",
"type": "Default",
"rate": "0.73",
"min": "100",
"max": "10000",
"dripfeed": false,
"refill": false,
"cancel": false,
"description": "-"
},
{
"service": 2,
"name": "Comments",
"type": "Custom Comments",
"category": "Second Category",
"rate": "12",
"min": "10",
"max": "2500",
"refill": false,
"cancel": true,
"description": "-"
}
]
POST/api/v2
Get Order Status (status)
Get the status of an order.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "status" | Yes |
order | number | Order ID | Yes |
Get Order Status Example
curl --location 'https://domain.com/api/v2' \
--form 'action="status"' \
--form 'key="YOUR_API_KEY"' \
--form 'order="123456"'
Response
{
"charge": "0.65788",
"start_count": "12",
"status": "Pending",
"remains": "200",
"currency": "EUR"
}
POST/api/v2
Get Multiple Orders Status (status)
Get the status of multiple orders.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "status" | Yes |
orders | string | Order ID | Yes |
Get Multiple Orders Status Example
curl --location 'https://domain.com/api/v2' \
--form 'action="status"' \
--form 'key="YOUR_API_KEY"' \
--form 'orders="123456,123457,123458"'
Response
{
"123456": {
"charge": "1.03841045",
"start_count": "1",
"status": "In progress",
"remains": "287",
"currency": "EUR"
},
"123457": {
"charge": "0.657880205",
"start_count": "12",
"status": "Pending",
"remains": "23",
"currency": "EUR"
},
"123458": {
"error": "Incorrect order ID"
}
}
POST/api/v2
Create Refill (refill)
Create a refill for an order.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "refill" | Yes |
order | number | Order ID | Yes |
Create Refill Example
curl --location 'https://domain.com/api/v2' \
--form 'action="refill"' \
--form 'key="YOUR_API_KEY"' \
--form 'order="123456"'
Response
{
"order": "123456",
"refill": "1", // Refill ID
"message": "Your refill request has been received, please wait."
}
POST/api/v2
Create Multiple Refills (refill)
Create multiple refills for orders.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "refill" | Yes |
orders | string | Order ID | Yes |
Create Multiple Refills Example
curl --location 'https://domain.com/api/v2' \
--form 'action="refill"' \
--form 'key="YOUR_API_KEY"' \
--form 'orders="123456,123457,123458"'
Response
[
{
"order": 123456,
"refill": 1, // Refill ID
"message": "Your refill request has been received, please wait."
},
{
"order": 123457,
"refill": 2, // Refill ID
"message": "Your refill request has been received, please wait."
},
{
"order": 123458,
"refill": {
"error": "Order cannot be refilled"
},
"message": "Order cannot be refilled"
}
]
POST/api/v2
Get Refill Status (refill_status)
Get the status of a refill.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "refill_status" | Yes |
refill | number | Refill ID | Yes |
Get Refill Status Example
curl --location 'https://domain.com/api/v2' \
--form 'action="refill_status"' \
--form 'key="YOUR_API_KEY"' \
--form 'refill="123456"'
Response
{
"refill": 123456,
"status": "Completed" // Pending, In Progress, Completed, Rejected, Failed
}
POST/api/v2
Get Multiple Refills Status (refill_status)
Get the status of multiple refills.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "refill_status" | Yes |
refills | string | Refill ID | Yes |
Create Multiple Refills Example
curl --location 'https://domain.com/api/v2' \
--form 'action="refill_status"' \
--form 'key="YOUR_API_KEY"' \
--form 'refills="123456,123457,123458"'
Response
[
{
"refill": 123456,
"status": "Completed"
},
{
"refill": 123457,
"status": "Rejected"
},
{
"refill": 123458,
"status": {
"error": "Refill not found"
}
}
]
POST/api/v2
Cancel Order (cancel)
Cancel an order.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "cancel" | Yes |
order | number | Order ID | Yes |
Cancel Order Example
curl --location 'https://domain.com/api/v2' \
--form 'action="cancel"' \
--form 'key="YOUR_API_KEY"' \
--form 'order="123456"'
Response
{
"order": 123456,
"cancel": "Your cancellation request has been received."
}
POST/api/v2
Cancel Multiple Orders (cancel)
Cancel multiple orders.
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
key | string | Your API key | Yes |
action | string | Must be "cancel" | Yes |
orders | string | Order ID | Yes |
Cancel Multiple Orders Example
curl --location 'https://domain.com/api/v2' \
--form 'action="cancel"' \
--form 'key="YOUR_API_KEY"' \
--form 'orders="123456,123457,123458"'
Response
[
{
"order": 123456,
"cancel": {
"error": "Incorrect order ID"
}
},
{
"order": 123457,
"cancel": "Your cancellation request has been received."
},
{
"order": 123458,
"cancel": "Your cancellation request has been received."
}
]