API
| HTTP Method | POST |
|---|---|
| API URL | https://socneo.com/api/v2 |
| API Key | Get it at /account/api (2FA required) |
| Response format | JSON |
Service list
| Parameter | Description |
|---|---|
key |
Your API key |
action |
services |
Response:
[
{
"service": 1,
"name": "Followers",
"type": "Default",
"category": "First Category",
"rate": "0.90",
"min": "50",
"max": "10000",
"refill": true,
"cancel": true
}
]
Add order
| Parameter | Description |
|---|---|
key |
Your API key |
action |
add |
service |
Service ID |
link |
Link to page |
quantity |
Needed quantity |
Response:
{ "order": 23501 }
Order status
| Parameter | Description |
|---|---|
key |
Your API key |
action |
status |
order |
Order ID |
Response:
{
"charge": "0.27819",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD"
}
Multiple orders status
| Parameter | Description |
|---|---|
key |
Your API key |
action |
status |
orders |
Order IDs separated by comma (max 100) |
Response:
{
"1": { "charge": "0.27819", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}
Refill
| Parameter | Description |
|---|---|
key |
Your API key |
action |
refill |
order |
Order ID |
Response:
{ "refill": "1" }
Refill status
| Parameter | Description |
|---|---|
key |
Your API key |
action |
refill_status |
refill |
Refill ID |
Response:
{ "status": "Completed" }
Cancel order
| Parameter | Description |
|---|---|
key |
Your API key |
action |
cancel |
orders |
Order IDs separated by comma (max 100) |
Response:
{
"1": { "cancel": true },
"2": { "error": "Incorrect order ID" }
}
Add VIP order
| Parameter | Description |
|---|---|
key |
Your API key |
action |
add_vip |
service |
Service ID |
link |
Link to page |
quantity |
Quantity |
days |
Days (multiple of 30) |
max_post |
Max posts |
comments |
Optional — comments separated by \n |
idempotency_key |
Optional — idempotency key |
Response:
{ "order": 12345 }
Update VIP order
| Parameter | Description |
|---|---|
key |
Your API key |
action |
update_vip |
order |
Order ID |
comments |
Comments separated by \n |
note |
Optional — note |
Response:
{ "order": 12345, "updated": true }
Extend VIP order
| Parameter | Description |
|---|---|
key |
Your API key |
action |
extend_vip |
order |
Order ID |
days |
Days (multiple of 30) |
expected_charge |
Optional — expected charge (VND) |
idempotency_key |
Optional — idempotency key |
Response:
{
"order": 12345,
"extended": true,
"days": 30,
"months": 4,
"ends_at": "2026-08-04T10:30:00+00:00"
}
Response when the price changed (expected_charge mismatch):
{
"error": "Price has changed. Please reload your quote and retry.",
"price_changed": true,
"expected_charge": 200000,
"actual_charge": 220000
}
Add post VIP
| Parameter | Description |
|---|---|
key |
Your API key |
action |
add_post_vip |
order |
Order ID |
link |
Link to post |
Response:
{
"order": 12345,
"post": 678,
"posts_used": 4,
"max_post": 30
}
Refund VIP order
| Parameter | Description |
|---|---|
key |
Your API key |
action |
refund_vip |
order |
Order ID |
Response:
{
"order": 12345,
"refund_request": 88,
"status": "pending_provider",
"penalty_days": 7
}
List VIP orders
| Parameter | Description |
|---|---|
key |
Your API key |
action |
list_vip |
orders |
Order IDs separated by comma (max 100) |
Response:
{
"106": {
"order": 106,
"status": "active",
"charge": "2.0000",
"currency": "USD",
"quantity": 100,
"months": 1,
"max_post": 30,
"posts_used": 4,
"link": "https://instagram.com/p/abc",
"started_at": "2026-05-01T10:30:00+00:00",
"ends_at": "2026-05-31T10:30:00+00:00",
"days_remaining": 26
},
"107": { "error": "Order not found." }
}
VIP order logs
| Parameter | Description |
|---|---|
key |
Your API key |
action |
vip_log |
order |
Order ID |
limit |
Optional — number of latest logs (default 50, max 200) |
Rate limit: 60 requests/hour/user (configurable). When exceeded → {"error": "Too many vip_log requests. Please wait until next hour."}.
Response:
{
"order": 12345,
"count": 3,
"logs": [
{
"id": 9821,
"type": "status_change",
"message": "Order activated",
"created_at": "2026-05-04T08:15:00+00:00"
},
{
"id": 9820,
"type": "create",
"message": "Order created",
"created_at": "2026-05-04T08:14:55+00:00"
},
{
"id": 9819,
"type": "refund_request",
"message": "Refund requested",
"created_at": "2026-05-04T08:14:30+00:00"
}
]
}
User balance
| Parameter | Description |
|---|---|
key |
Your API key |
action |
balance |
Response:
{ "balance": "100.84292", "currency": "USD" }