TitanService API
Integrate our SMM services directly into your application.
REST API
JSON Response
Compatible with all SMM panels
Base Endpoint
ENDPOINT
POST https://mail.titanservice.io.vn/api/v2
All requests must be sent as POST or GET to this endpoint with the required parameters.
Authentication
Every request requires your API key passed as the key parameter. You can find your API key in your Account Settings.
Keep your API key secret. Do not expose it in client-side code or public repositories.
EXAMPLE REQUEST
# POST request with form data key=YOUR_API_KEY_HERE action=services
Get Services
POST
action=services
Returns a list of all available services with pricing and limits.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be services |
RESPONSE
[
{
"service": 1,
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "0.50",
"min": "100",
"max": "10000",
"dripfeed": false,
"refill": false
}
]
Add Order
POST
action=add
Place a new order. The charge will be deducted from your balance automatically.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be add |
| service | integer | Required | Service ID from services list |
| link | string | Required | Target URL (profile, post, etc.) |
| quantity | integer | Required | Number of units to order |
RESPONSE
{
"order": 12345
}
Order Status
POST
action=status
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be status |
| order | integer | Required | Order ID returned from add |
RESPONSE
{
"charge": "0.27",
"start_count": "3572",
"status": "In progress",
"remains": 157,
"currency": "USD"
}
Possible Status Values
Pending
Processing
In progress
Completed
Partial
Canceled
Refunded
Multi Status
POST
action=multi-status
Check status of multiple orders at once. Pass comma-separated order IDs.
EXAMPLE
key=YOUR_KEY&action=multi-status&orders=1,2,3
Get Balance
POST
action=balance
RESPONSE
{
"balance": "100.84",
"currency": "VND"
}
Error Codes
| HTTP Code | Error | Description |
|---|---|---|
| 400 | Invalid action | The action parameter is missing or not recognized. |
| 400 | Missing required fields | One or more required parameters are missing. |
| 400 | Insufficient balance | Your account balance is too low for this order. |
| 400 | Quantity out of range | The quantity is below min or above max for this service. |
| 401 | API key is missing | The key parameter was not provided. |
| 401 | Invalid API key | The provided API key does not match any active account. |
| 404 | Order not found | The order ID does not exist or does not belong to your account. |