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.

Tạo API 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ênBắt buộcMô tả
keyCóAPI key của bạn.
actionCó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ênBắt buộcMô tả
keyCóAPI key của bạn.
actionCóLuôn là add.
serviceCóMã dịch vụ, lấy từ services.
linkCóLink hoặc @username cần tăng, tối đa 500 ký tự.
quantityCóSố lượng, trong mức tối thiểu và tối đa của dịch vụ.
runsKhôngDrip-feed: số lần chạy, từ 2 đến 100; cần kèm interval.
intervalKhôngDrip-feed: số phút giữa hai lần chạy, từ 1 đến 1440; cần kèm runs.
commentsKhôngChỉ 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 IDKhông có dịch vụ đang bán với mã này.
Service is under maintenanceDịch vụ đang bảo trì, tạm không nhận đơn.
Incorrect linkLink sai dạng: cần http(s) hoặc @username, tối đa 500 ký tự.
Incorrect quantityThiếu số lượng hoặc số lượng không phải số nguyên.
Quantity less than minimal 100Dưới mức tối thiểu của dịch vụ; con số trong câu là mức đó.
Quantity more than maximal 50000Vượt mức tối đa của dịch vụ; con số trong câu là mức đó.
Incorrect runs or intervalruns hoặc interval ngoài khoảng cho phép, hoặc chỉ gửi một trong hai.
Drip-feed not supportedDịch vụ không hỗ trợ drip-feed.
Comments requiredDịch vụ bình luận cần comments.
Comment too longCó bình luận dài hơn 500 ký tự.
Too many commentsHơn 1.000 dòng bình luận.
Comments not supportedDịch vụ này không nhận comments.
Not enough funds on balanceSố 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ênBắt buộcMô tả
keyCóAPI key của bạn.
actionCóLuôn là status.
orderChọn mộtMã một đơn.
ordersChọn mộtTố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 IDKhông có đơn này trong tài khoản của bạn.
Too many ordersHơn 100 mã đơn trong một lệnh.

balance

Số dư hiện tại.

Tham số

TênBắt buộcMô tả
keyCóAPI key của bạn.
actionCó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ênBắt buộcMô tả
keyCóAPI key của bạn.
actionCóLuôn là refill.
orderChọn mộtMã một đơn.
ordersChọn mộtTố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 IDKhô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 ordersHơ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ênBắt buộcMô tả
keyCóAPI key của bạn.
actionCóLuôn là refill_status.
refillCó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 IDKhô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ênBắt buộcMô tả
keyCóAPI key của bạn.
actionCóLuôn là cancel.
ordersCó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 IDKhô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 ordersHơ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 keyThiếu key, key sai, hoặc key đã bị thay bằng key mới.
Account is lockedTài khoản đang bị khoá.
Incorrect requestThiếu action, action không có, hoặc gọi bằng GET.
Too many requestsQuá 60 lệnh trong một phút (HTTP 429); chờ rồi gọi lại.
Internal errorLỗ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.