API
| HTTP Method | POST |
|---|---|
| API URL | https://socneo.com/api/v2 |
| API Key | Lấy tại /account/api (yêu cầu bật 2FA) |
| Định dạng phản hồi | JSON |
Danh sách dịch vụ
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
services |
Phản hồi:
[
{
"service": 1,
"name": "Followers",
"type": "Default",
"category": "First Category",
"rate": "0.90",
"min": "50",
"max": "10000",
"refill": true,
"cancel": true
}
]
Tạo đơn hàng
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
add |
service |
ID dịch vụ |
link |
Đường dẫn cần chạy |
quantity |
Số lượng cần |
Phản hồi:
{ "order": 23501 }
Trạng thái đơn
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
status |
order |
ID đơn |
Phản hồi:
{
"charge": "0.27819",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD"
}
Trạng thái nhiều đơn
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
status |
orders |
Danh sách ID đơn, ngăn cách dấu phẩy (tối đa 100) |
Phản hồi:
{
"1": { "charge": "0.27819", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}
Bảo hành (refill)
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
refill |
order |
ID đơn |
Phản hồi:
{ "refill": "1" }
Trạng thái bảo hành
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
refill_status |
refill |
ID phiên refill |
Phản hồi:
{ "status": "Completed" }
Hủy đơn
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
cancel |
orders |
Danh sách ID đơn, ngăn cách dấu phẩy (tối đa 100) |
Phản hồi:
{
"1": { "cancel": true },
"2": { "error": "Incorrect order ID" }
}
Tạo đơn VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
add_vip |
service |
ID dịch vụ |
link |
Đường dẫn |
quantity |
Số lượng |
days |
Số ngày (bội số của 30) |
max_post |
Số bài tối đa |
comments |
Tùy chọn — comment, ngăn cách \n |
idempotency_key |
Tùy chọn — khóa idempotency |
Phản hồi:
{ "order": 12345 }
Cập nhật đơn VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
update_vip |
order |
ID đơn |
comments |
Comment, ngăn cách \n |
note |
Tùy chọn — ghi chú |
Phản hồi:
{ "order": 12345, "updated": true }
Gia hạn đơn VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
extend_vip |
order |
ID đơn |
days |
Số ngày (bội số của 30) |
expected_charge |
Tùy chọn — số tiền dự tính (VND) |
idempotency_key |
Tùy chọn — khóa idempotency |
Phản hồi:
{
"order": 12345,
"extended": true,
"days": 30,
"months": 4,
"ends_at": "2026-08-04T10:30:00+00:00"
}
Phản hồi khi giá thay đổi (expected_charge lệch):
{
"error": "Price has changed. Please reload your quote and retry.",
"price_changed": true,
"expected_charge": 200000,
"actual_charge": 220000
}
Bù bài VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
add_post_vip |
order |
ID đơn |
link |
Link bài cần bù |
Phản hồi:
{
"order": 12345,
"post": 678,
"posts_used": 4,
"max_post": 30
}
Hoàn tiền đơn VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
refund_vip |
order |
ID đơn |
Phản hồi:
{
"order": 12345,
"refund_request": 88,
"status": "pending_provider",
"penalty_days": 7
}
Trạng thái nhiều đơn VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
list_vip |
orders |
Danh sách ID đơn, ngăn cách dấu phẩy (tối đa 100) |
Phản hồi:
{
"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." }
}
Nhật ký đơn VIP
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
vip_log |
order |
ID đơn |
limit |
Tùy chọn — số log gần nhất (mặc định 50, tối đa 200) |
Giới hạn: 60 request/giờ/user (có thể chỉnh trong cấu hình). Quá ngưỡng sẽ trả {"error": "Too many vip_log requests. Please wait until next hour."}.
Phản hồi:
{
"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"
}
]
}
Số dư
| Tham số | Mô tả |
|---|---|
key |
API key của bạn |
action |
balance |
Phản hồi:
{ "balance": "100.84292", "currency": "USD" }