MINSHOPEE SIGN CLOUD
Tổng Quan & Bảng Giá Dịch Vụ
Giải pháp chữ ký bảo mật và truy xuất dữ liệu Shopee trực tiếp dành cho doanh nghiệp
BẢNG GIÁ GÓI CƯỚC
Chọn nhịp chạy của bạn.
Thanh toán tự động qua mã QR ngân hàng (VietQR) hoặc kích hoạt tức thì từ số dư ví bằng 1 mã X-API-Key cố định duy nhất.
CHẾ ĐỘ TRẢ THEO LƯỢT KÝ (PAY-AS-YOU-GO)
Dùng bao nhiêu trừ bấy nhiêu (150 đ/lượt)
Nạp tiền vào ví và trừ trực tiếp theo từng lượt ký thành công. Không giới hạn ngày hết hạn, tự động kích hoạt dự phòng khi gói tháng hết lượt trong ngày.
Đăng Nhập Để Quản Lý Ví & Nạp Tiền VietQR
Hệ thống tự động khởi tạo mã QR chuyển khoản MB Bank chính xác theo từng mã đơn hàng, hỗ trợ thanh toán gói tháng hoặc trừ lẻ theo từng lượt ký.
| Mã Đơn | Số Tiền | Nội Dung CK | Trạng Thái | Thao Tác |
|---|---|---|---|---|
| Chưa có giao dịch nạp tiền nào | ||||
| Mã GD | Gói Dịch Vụ | Số Tiền | Thời Gian |
|---|---|---|---|
| Chưa có lịch sử đăng ký gói | |||
103.1.*) để khóa bảo vệ Key. (Mặc định khi Test trực tiếp trên Web Sign này sẽ chạy qua Server nội bộ và luôn được phép).
| Tên Trường Header | Giá Trị Chữ Ký (Vé Thông Hành) | Thao Tác |
|---|
// Chọn quốc gia, mẫu API bên trên và bấm [Gửi Ký Ngay] để nhận bộ Header Vé Thông Hành...
URL, chuỗi Body và mốc thời gian thực. Nếu thiếu bộ chữ ký này hoặc chữ ký không khớp, Shopee sẽ từ chối trả dữ liệu.Do đó, API
POST /api/v1/sign đóng vai trò cấp “Vé Thông Hành” (Pass Ticket) hợp lệ cho phần mềm của bạn chỉ trong vài chục mili-giây để đi qua lớp kiểm tra bảo mật của Shopee một cách ổn định.
url (đường dẫn API Shopee cần gọi) và body (nếu là POST) kèm Header X-API-Key lên POST https://vip-sign.minmintool.site/api/v1/sign.
data)data chứa trọn bộ các trường Header bảo mật tương ứng với phiên thiết bị cố định (deviceId) của bạn.
data vào HTTP Headers (kèm Cookie tài khoản hoặc Proxy riêng của bạn nếu cần) và gọi thẳng lên máy chủ Shopee để nhận dữ liệu!
POST /api/v1/sign) & Kiểm Tra Hạn MứcPOST https://vip-sign.minmintool.site/api/v1/signGET https://vip-sign.minmintool.site/api/v1/key/check?key=YOUR_API_KEYX-API-Key: <Mã_API_Key_Của_Bạn> (hoặc truyền trong JSON trường apiKey)HTTP 200 tính 1 lượt ký (áp dụng cho cả gọi từ code phần mềm lẫn bấm Test trên Web).POST /api/v1/sign)| Trường | Kiểu / Bắt Buộc | Mô Tả Chi Tiết |
|---|---|---|
| url | String • Bắt buộc | Đường dẫn đầy đủ của API Shopee cần ký (bao gồm cả query params nếu là GET). |
| body | String • Tuỳ chọn | Chuỗi JSON Body nếu gọi phương thức POST. Để trống "" nếu gọi GET. |
| country | String • Tuỳ chọn | Mã quốc gia Shopee ("VN", "TH", "ID", "MY", "SG", "PH", "TW", "BR"). Mặc định "VN". |
| deviceId | String • Tuỳ chọn | Mã định danh phiên thiết bị cố định. Truyền cùng 1 deviceId cho cùng 1 tài khoản Shopee để giữ phiên ổn định lâu dài. |
| fetchLive | Boolean • Tuỳ chọn | Đặt false (mặc định) nếu chỉ lấy bộ Header chữ ký (không cần Proxy). Đặt true nếu muốn máy chủ lấy luôn dữ liệu thật từ Shopee (bắt buộc truyền kèm proxy). |
| proxy | String • Bắt buộc khi Live | Proxy HTTP/HTTPS cá nhân khi bật fetchLive: true hoặc giải link rút gọn shp.ee (VD: "ip:port:user:pass" hoặc "http://user:pass@ip:port"). Hệ thống không dùng IP Server gốc gửi lên Shopee. |
| Trường | Kiểu Dữ Liệu | Ý Nghĩa & Cách Sử Dụng |
|---|---|---|
| code | Integer | Mã trạng thái xử lý (0 = Ký thành công). |
| data | Object (Map) | Chứa trọn bộ Header chữ ký bảo mật (“Vé Thông Hành”). Bạn lặp qua toàn bộ key-value trong data để gắn vào HTTP Request Headers khi gọi Shopee. |
| device | Object | Chứa thông tin phiên thiết bị cố định (deviceId, model, brand, osVersion, appVersion) tương ứng với bộ chữ ký. |
| costMs | Long | Thời gian máy chủ thực hiện tính toán chữ ký bảo mật (tính bằng mili-giây). |
import requests
API_KEY = "ms_live_YOUR_API_KEY"
SIGN_ENDPOINT = "https://vip-sign.minmintool.site/api/v1/sign"
TARGET_URL = "https://shopee.vn/api/v4/item/get?itemid=23456789012&shopid=88201679"
# Bước 1: Xin Vé Thông Hành (Bộ Header chữ ký bảo mật)
sign_res = requests.post(
SIGN_ENDPOINT,
headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
json={
"url": TARGET_URL,
"body": "",
"country": "VN",
"deviceId": "acc-shopee-01",
"fetchLive": False
},
timeout=15
).json()
pass_ticket_headers = sign_res.get("data", {})
pass_ticket_headers["Cookie"] = "SPC_EC=your_shopee_cookie_if_needed"
# Bước 2: Gắn Vé Thông Hành vào Header và gọi trực tiếp Shopee
shopee_res = requests.get(TARGET_URL, headers=pass_ticket_headers, timeout=15)
print("Shopee HTTP:", shopee_res.status_code)
print(shopee_res.json())
| Mã deviceId (Tái Sử Dụng) | Dòng Máy & Phần Cứng | Bản Build OTA & Mạng | Android ID & SPC_F | User-Agent Đồng Bộ | Thao Tác |
|---|---|---|---|---|---|
| Bấm [+ Khởi Tạo Hồ Sơ Thiết Bị Cố Định Ngay] bên trên để tạo danh sách thiết bị riêng cho bạn. | |||||
// 1. Khi gọi POST /api/v1/sign với deviceId cố định:
{
"url": "https://sv.shopee.vn/api/v2/timeline/single?video_id=...",
"body": "",
"country": "VN",
"deviceId": "sam_nick_shopee_01",
"brand": "samsung"
}
// 2. Phản hồi trả về có sẵn recommendedUserAgent & recommendedSpcF khớp 100% với máy:
// resp.data -> Gắn toàn bộ vào HTTP Headers gọi Shopee
// resp.device.recommendedUserAgent -> Gắn vào Header 'User-Agent'
// resp.device.recommendedSpcF -> Gắn vào Cookie 'SPC_F=...' nếu chưa có
// Chọn một kịch bản bên trên (VD: Lấy Shop Apple hoặc Đăng Video Shopee) và bấm [Gửi Request Test API Thật Ngay]...
Tích Hợp Đẩy View Shopee Video & Affiliate Bằng MinSign Native SDK
Toàn bộ quy trình giải link rút gọn, mở bài lấy view_token, tải mồi MP4 Range và bắn sự kiện c-api-bit qua Proxy xoay đã được đóng gói sẵn trong hàm BuffVideoBatch của minsign_sdk.dll.
| Tên Param (JSON / C# / JS) | Tên Param Python | Bắt Buộc? | Tham Số Này Là Gì & Lấy Ở Đâu Ngoài Thực Tế? |
|---|---|---|---|
| apiKey | api_key | Bắt buộc | Mã xác thực truyền vào lúc khởi tạo MinSignClient. Lấy ngay tại tab Quản Lý API Key trên trang web này. |
| videoUrl | video_url | Bắt buộc* | Link bài đăng Shopee Video cần đẩy view. Cách lấy: Mở video trên App Shopee → bấm nút Chia sẻ (Share) → chọn Sao chép liên kết. Truyền thẳng link rút gọn https://vn.shp.ee/... hoặc link đầy đủ https://sv.shopee.vn/share-video/... (hoặc lấy từ trường shareUrl của hàm get_shop_videos). |
| postId | post_id | Tuỳ chọn | Mã ID gốc của bài đăng (VD: "c4PVehg9CgChmFCrAwAAAA=="). Nếu đã truyền videoUrl thì để trống "" (SDK tự bóc). Nếu quét danh sách video từ get_shop_videos, truyền thẳng postId sẽ bỏ qua bước giải link rút gọn (nhanh hơn ~150ms). |
| targetViews | target_views | Batch (Mặc định 10) | Chỉ dùng cho buff_video_batch: Tổng số lượt xem muốn đẩy trong đợt gọi này (VD: 50, 200, 1000). |
| concurrency | concurrency | Batch (Mặc định 5) | Số luồng chạy đồng thời bên trong DLL (tối đa 200). Mẹo: Nên đặt nhỏ hơn hoặc bằng tổng số Proxy xoay trong danh sách proxies. |
| proxy / proxies | proxy / proxies | Cần khi đẩy SLL | Đơn lẻ truyền chuỗi proxy, chạy Batch truyền mảng proxies: string[]. Shopee lọc trùng nếu 1 IP xem liên tục; nếu chỉ test 1–2 lượt trên máy có thể truyền "" / []. Lấy ở đâu: Mua Proxy xoay Dân cư / 4G (TMProxy, WWProxy, Tinsoft, ZingProxy, LunaProxy...). SDK tự nhận mọi định dạng: "ip:port:user:pass", "ip:port", "http://user:pass@ip:port", "socks5://...". |
| cookie / cookies | cookie / cookies | Không bắt buộc | Để trống "" / [] (Khuyên dùng mặc định): SDK tự chạy chế độ Guest Vãng Lai — mỗi lượt xem tự cấp mới 1 điện thoại Android 14 + mã SPC_F riêng biệt, không cần nuôi tài khoản Shopee! Nếu truyền Cookie nick phụ ("SPC_U=...; SPC_ST=...;" lấy từ F12 trình duyệt / tool nuôi nick), SDK sẽ tính view đăng nhập và giữ cố định máy cho nick trong devices_vault.json. |
| watchSeconds | watch_seconds | Mặc định 18 | Số giây xem video gửi lên bộ đếm của Shopee (seg_duration). Khuyên đặt trong khoảng 15 – 25 giây để có tỷ lệ giữ chân tốt nhất. |
| country | country | Mặc định "VN" | Mã quốc gia của video ("VN", "TW", "PH", "MY", "TH", "ID", "SG", "BR"). Nếu truyền videoUrl đầy đủ SDK sẽ tự nhận diện vùng. |
{
"country": "VN",
"postId": "c4PVehg9CgChmFCrAwAAAA==",
"targetViews": 100,
"concurrency": 10,
"successViews": 98,
"failedViews": 2,
"reportedViews": 1348,
"lastError": "",
"elapsedMs": 9420
}
{
"success": true,
"postId": "c4PVehg9CgChmFCrAwAAAA==",
"videoId": "vn-11110105-6ke17-m1...",
"authorName": "ten_kenh_video",
"currentViews": 1250,
"vodStreamStatus": 206,
"ubtHttpStatus": 200,
"totalLatencyMs": 840
}
Bạn gửi URL API Shopee (hoặc dán thẳng link sản phẩm / link gian hàng Shopee bất kỳ) kèm tham số "fetchLive": true và "proxy" (HTTP/HTTPS Proxy cá nhân) lên POST /api/v1/sign.
- Máy chủ MinSign tự động khởi tạo "Vé Thông Hành", đi qua đúng Proxy bạn truyền vào để gọi lên Shopee (tuyệt đối không dùng IP Server gốc) và bóc tách sẵn dữ liệu sạch đẹp trong trường liveShopee (shop, items, vouchers, categories).
- Ưu điểm vượt trội: Rất tiện lợi khi bạn muốn nhận ngay JSON sản phẩm, giá bán, tồn kho, mã giảm giá đã chuẩn hóa qua Proxy riêng (ip:port:user:pass hoặc http://user:pass@ip:port).
Bạn gọi POST /api/v1/sign với "fetchLive": false để nhận bộ Header chữ ký trong đối tượng data, sau đó phần mềm của bạn tự gửi HTTP Request lên Shopee qua Proxy và Cookie tài khoản riêng.
- Ưu điểm vượt trội: Phù hợp cho các chức năng bắt buộc đăng nhập tài khoản Shopee cá nhân (thêm sản phẩm vào giỏ hàng, kiểm tra phí vận chuyển, đặt hàng, săn Flash Sale) hoặc hệ thống cào dữ liệu đa luồng quy mô lớn qua dàn Proxy riêng.
- Đảm bảo toàn quyền kiểm soát IP kết nối, phiên đăng nhập Cookie và luồng xử lý tại máy trạm của bạn.
Ứng dụng thực tế: Ký bảo mật cho API khởi tạo phiên tải lên Video Shopee (upload/create) và đăng bài gắn link sản phẩm Affiliate (post/create) đa quốc gia (VN, PH, MY, TH, ID, SG, TW, BR).
Cơ chế tính View thật của Shopee Video: (1) Gọi GET sv.shopee.vn/api/v2/timeline/single?post_id=...&need_product_v2=true (hoặc dán thẳng link https://sv.shopee.vn/share-video/...) để lấy luồng MP4, số view hiện tại (count_info.views) và mã view_token → (2) Tải luồng MP4 (Range: bytes=0-65535) và bắn mảng sự kiện video_impression + video_play + video_play_time kèm view_token lên POST https://c-api-bit.shopeemobile.com/v4/tr/vn (trả về HTTP 200: Success) → (3) Gọi GET sv.shopee.vn/api/v2/timeline/me?request_user_id=... để kiểm tra danh sách video & tổng view toàn kênh.
Ứng dụng thực tế: Nhập username của bất kỳ gian hàng nào (VD: apple_flagship_store, samsung_official_store) để lấy thông tin Shop (Tên, ShopID, Đánh giá sao, Người theo dõi, Tổng số sản phẩm) kèm danh sách sản phẩm thật (Tên SP, Ảnh, Giá bán VNĐ, Đã bán, Tồn kho).
Ứng dụng thực tế: Khách hàng chỉ cần copy nguyên đường link sản phẩm trên trình duyệt (VD: https://shopee.vn/...-i.88201679.24459402585) hoặc link gian hàng (https://shopee.vn/ten_shop) truyền vào trường url. Hệ thống tự động nhận diện shopid, itemid và trả về dữ liệu sản phẩm + gian hàng!
Ứng dụng thực tế: Lấy toàn bộ các mã Voucher khuyến mãi của một Shop theo shopid (Mã code, % giảm giá hoặc số tiền giảm, giá trị đơn hàng tối thiểu, mức giảm tối đa, hạn sử dụng) phục vụ hệ thống săn mã hoặc so sánh khuyến mãi.
Ứng dụng thực tế: Trích xuất toàn bộ danh mục ngành hàng chính thức của Shopee (catid, Tên danh mục tiếng Việt, Ảnh icon, Danh mục con cấp 2/3) để đồng bộ vào phần mềm quản lý bán hàng hoặc công cụ nghiên cứu thị trường.
Ứng dụng thực tế: Quét danh sách sản phẩm trả về theo từ khóa tìm kiếm (keyword), lọc theo khoảng giá, nơi bán hoặc sắp xếp theo doanh số (ctime, sales, price) để làm công cụ đo thứ hạng từ khóa SEO và nghiên cứu đối thủ.
Ứng dụng thực tế: Truy xuất chi tiết một sản phẩm theo itemid và shopid, bao gồm danh sách biến thể (models: Màu sắc, Dung lượng, Giá từng phân loại, Tồn kho từng loại), danh sách ảnh/video, thông số kỹ thuật và mô tả chi tiết.
Ứng dụng thực tế: Ký bảo mật cho phương thức POST kèm JSON Body (itemid, shopid, modelid, quantity) để phần mềm tự động thêm sản phẩm chỉ định vào giỏ hàng của tài khoản Shopee.
Ứng dụng thực tế: Ký bảo mật cho payload kiểm tra thanh toán (shoporders, selected_shop_order_ids, promotion_data) để tính phí vận chuyển, áp mã giảm giá và tự động hóa quy trình lên đơn.
| Trường Dữ Liệu | Kiểu | Mô Tả Chi Tiết Các Trường Con |
|---|---|---|
| liveShopee.httpStatus | Number | Mã phản hồi HTTP thực tế từ máy chủ Shopee (200 = Truy xuất dữ liệu thành công). |
| liveShopee.shop | Object | Thông tin hồ sơ cửa hàng đã chuẩn hóa: shopId, username, name, ratingStar, followerCount, itemCount, responseRate, place. |
| liveShopee.items | Array | Danh sách sản phẩm thật của Shop (giá đã tự động quy đổi ra VNĐ chuẩn): itemId, shopId, name, priceVnd, priceMinVnd, sold, historicalSold, stock, imageUrl, productUrl. |
| liveShopee.targetItem | Object | Thông tin chi tiết của sản phẩm mục tiêu khi bạn truyền trực tiếp đường link sản phẩm Shopee cụ thể vào trường url. |
| liveShopee.vouchers | Array | Danh sách mã giảm giá đang hoạt động của Shop: promotionId, voucherCode, title, minSpendVnd, discountPct, discountValueVnd. |
| liveShopee.categories | Array | Danh sách ngành hàng chính thức trên Shopee: catId, name, displayName, imageUrl, childrenCount. |
| liveShopee.rawBody | String | Toàn bộ chuỗi JSON gốc nguyên bản trả về từ Shopee để lập trình viên tùy ý JSON.parse() và khai thác thêm bất kỳ trường nâng cao nào. |