Tài liệu API cho đại lý
Cập nhật ngày 16/11/2026
API theo chuẩn SMM API v2, nên phần mềm panel có sẵn chỉ cần đổi địa chỉ và key. Key được tạo trong tài khoản, ở mục API cho đại lý; các ví dụ dưới đây ghi YOUR_API_KEY ở chỗ của key.
Cách gọi
Lệnh nào cũng gửi key và action.
- Địa chỉ API
- https://seodee.vn/api/v2
- Phương thức
- POST
- Gửi dạng
- Form (application/x-www-form-urlencoded) hoặc JSON
- Kết quả
- JSON, luôn HTTP 200; khi lỗi có trường error
- Giới hạn
- 60 lệnh mỗi phút; quá thì HTTP 429
- Số tiền
- VND, dạng chuỗi số nguyên
Các hành động
services
Danh sách dịch vụ đang bán, giá theo VND cho 1000.
rate là giá cho 1000 theo VND. type "Custom Comments" là dịch vụ bình luận: gửi comments thay cho quantity.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là services. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services"Kết quả mẫu
[
{
"service": 12,
"name": "TikTok Followers – Nhanh",
"type": "Default",
"category": "TikTok – Followers",
"rate": "43200",
"min": "100",
"max": "50000",
"refill": true,
"cancel": false,
"dripfeed": true
}
]add
Đặt một đơn; drip-feed thêm runs và interval.
Thành công thì tiền được trừ ngay và đơn ở trạng thái Pending.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là add. |
| service | Có | Mã dịch vụ, lấy từ services. |
| link | Có | Link hoặc @username cần tăng, tối đa 500 ký tự. |
| quantity | Có | Số lượng, trong mức tối thiểu và tối đa của dịch vụ. |
| runs | Không | Drip-feed: số lần chạy, từ 2 đến 100; cần kèm interval. |
| interval | Không | Drip-feed: số phút giữa hai lần chạy, từ 1 đến 1440; cần kèm runs. |
| comments | Không | Chỉ dịch vụ bình luận: mỗi dòng một bình luận, tối đa 1.000 dòng, mỗi dòng tối đa 500 ký tự; số dòng là số lượng. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=add" \
-d "service=12" \
-d "link=https://www.tiktok.com/@shop" \
-d "quantity=1500"Kết quả mẫu
{
"order": 10422
}Lỗi có thể gặp
| Lỗi | Ý nghĩa |
|---|---|
| Incorrect service ID | Không có dịch vụ đang bán với mã này. |
| Service is under maintenance | Dịch vụ đang bảo trì, tạm không nhận đơn. |
| Incorrect link | Link sai dạng: cần http(s) hoặc @username, tối đa 500 ký tự. |
| Incorrect quantity | Thiếu số lượng hoặc số lượng không phải số nguyên. |
| Quantity less than minimal 100 | Dưới mức tối thiểu của dịch vụ; con số trong câu là mức đó. |
| Quantity more than maximal 50000 | Vượt mức tối đa của dịch vụ; con số trong câu là mức đó. |
| Incorrect runs or interval | runs hoặc interval ngoài khoảng cho phép, hoặc chỉ gửi một trong hai. |
| Drip-feed not supported | Dịch vụ không hỗ trợ drip-feed. |
| Comments required | Dịch vụ bình luận cần comments. |
| Comment too long | Có bình luận dài hơn 500 ký tự. |
| Too many comments | Hơn 1.000 dòng bình luận. |
| Comments not supported | Dịch vụ này không nhận comments. |
| Not enough funds on balance | Số dư không đủ cho đơn này. |
status
Trạng thái một đơn, hoặc tối đa 100 đơn một lần.
status là một trong Pending, In progress, Completed, Partial, Canceled; đơn Canceled đã được hoàn đủ tiền. Gửi orders thì kết quả là một đối tượng theo từng mã đơn.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là status. |
| order | Chọn một | Mã một đơn. |
| orders | Chọn một | Tối đa 100 mã đơn, cách nhau bằng dấu phẩy. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=status" \
-d "order=10422"Kết quả mẫu
{
"charge": "64800",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "VND"
}Lỗi có thể gặp
| Lỗi | Ý nghĩa |
|---|---|
| Incorrect order ID | Không có đơn này trong tài khoản của bạn. |
| Too many orders | Hơn 100 mã đơn trong một lệnh. |
balance
Số dư hiện tại.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là balance. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=balance"Kết quả mẫu
{
"balance": "250000",
"currency": "VND"
}refill
Yêu cầu refill (bảo hành) đơn đã hoàn thành.
Gửi orders thì kết quả là danh sách theo từng đơn. Đơn hoàn thành chưa đủ 24 giờ, hoặc vừa được refill chưa đủ 24 giờ, trả về lỗi Refill not available.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là refill. |
| order | Chọn một | Mã một đơn. |
| orders | Chọn một | Tối đa 100 mã đơn, cách nhau bằng dấu phẩy. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=refill" \
-d "order=10422"Kết quả mẫu
{
"refill": 77
}Lỗi có thể gặp
| Lỗi | Ý nghĩa |
|---|---|
| Incorrect order ID | Không có đơn này trong tài khoản của bạn. |
| Refill not available | Đơn này hiện không refill được. |
| Too many orders | Hơn 100 mã đơn trong một lệnh. |
refill_status
Trạng thái một lần refill.
status là một trong Pending, In progress, Completed, Rejected.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là refill_status. |
| refill | Có | Mã refill nhận được từ refill. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=refill_status" \
-d "refill=77"Kết quả mẫu
{
"status": "Completed"
}Lỗi có thể gặp
| Lỗi | Ý nghĩa |
|---|---|
| Incorrect refill ID | Không có lần refill này trong tài khoản của bạn. |
cancel
Yêu cầu huỷ tối đa 100 đơn một lần.
cancel: 1 nghĩa là yêu cầu đã được nhận; tiền về khi đơn kết thúc.
Tham số
| Tên | Bắt buộc | Mô tả |
|---|---|---|
| key | Có | API key của bạn. |
| action | Có | Luôn là cancel. |
| orders | Có | Tối đa 100 mã đơn, cách nhau bằng dấu phẩy. |
Ví dụ gọi
curl -X POST https://seodee.vn/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=cancel" \
-d "orders=10422,10423"Kết quả mẫu
[
{
"order": 10422,
"cancel": 1
},
{
"order": 10423,
"cancel": {
"error": "Cancel not available"
}
}
]Lỗi có thể gặp
| Lỗi | Ý nghĩa |
|---|---|
| Incorrect order ID | Không có đơn này trong tài khoản của bạn. |
| Cancel not available | Đơn này hiện không huỷ được. |
| Too many orders | Hơn 100 mã đơn trong một lệnh. |
Lỗi chung
Hành động nào cũng có thể trả các lỗi này.
| Lỗi | Ý nghĩa |
|---|---|
| Invalid API key | Thiếu key, key sai, hoặc key đã bị thay bằng key mới. |
| Account is locked | Tài khoản đang bị khoá. |
| Incorrect request | Thiếu action, action không có, hoặc gọi bằng GET. |
| Too many requests | Quá 60 lệnh trong một phút (HTTP 429); chờ rồi gọi lại. |
| Internal error | Lỗi phía máy chủ (HTTP 500); gọi lại sau. |
Bắt đầu với Seodee
Đăng ký miễn phí, nạp theo nhu cầu và xem đơn chạy trong vài phút.