Tạo link rút gọn chính chủ (https://s.shopee.vn/…) bằng phiên affiliate bạn đã lưu trên addlivetag.com. Script của bạn chỉ gửi API Key — cookie không bao giờ đi qua request. Khác với link an_redir (tự build được, dài), đây là link ngắn y như link tạo trong trang affiliate của Sàn Cam.
Link sản phẩm, link shop, hoặc link rút gọn của người khác (s.shopee.vn, shp.ee) — tự bung về link gốc.
Copy toàn bộ tài liệu dạng text rồi dán vào ChatGPT / Claude / Gemini để AI viết code gọi API giúp bạn.
GET | POST https://addlivetag.com/api/v1/shopee-link.php
POST nhận cả form (application/x-www-form-urlencoded) lẫn JSON (application/json). Key gửi qua header X-API-Key (khuyên dùng) hoặc tham số api_key.
| Tham số | Bắt buộc | Ý nghĩa |
|---|---|---|
| url | 1 trong 2 | Một link Sàn Cam. |
| urls | 1 trong 2 | Tối đa 5 link: mảng JSON, hoặc chuỗi cách nhau bằng xuống dòng / dấu phẩy. |
| aff_id | Tùy chọn | Chọn tài khoản theo Affiliate ID. Bỏ trống = tài khoản còn cookie đầu tiên. |
| account_id | Tùy chọn | Chọn theo id tài khoản trên addlivetag (thay cho aff_id). |
| sub1 … sub5 | Tùy chọn | Sub-ID, chỉ chữ + số, ≤ 50 ký tự. Ký tự khác (dấu -, _, khoảng trắng, tiếng Việt có dấu) bị lọc bỏ. Áp chung cho cả lô. |
# 1 link, GET
curl -H "X-API-Key: YOUR_API_KEY" \
"https://addlivetag.com/api/v1/shopee-link.php?url=https://shopee.vn/product/1608621545/43363310862&sub1=fb"
# Nhiều link, POST JSON
curl -X POST https://addlivetag.com/api/v1/shopee-link.php \
-H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"urls":["https://shopee.vn/product/123/456","https://s.shopee.vn/xxxx"],"sub1":"zalo","aff_id":"12345678901"}'
// JavaScript (Node 18+ / trình duyệt phía server của bạn)
const r = await fetch('https://addlivetag.com/api/v1/shopee-link.php', {
method: 'POST',
headers: { 'X-API-Key': process.env.ADDLIVETAG_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ urls: ['https://shopee.vn/product/123/456'], sub1: 'fb' }),
});
const j = await r.json();
if (j.ok) j.data.forEach(d => console.log(d.input, '→', d.ok ? d.short_link : d.error));
{
"ok": true,
"account": { "id": 1, "aff_id": "12345678901" },
"data": [
{
"input": "https://shopee.vn/product/1608621545/43363310862",
"ok": true,
"short_link": "https://s.shopee.vn/AbCdEf123",
"long_link": "https://shopee.vn/universal-link/product/1608621545/43363310862?...&utm_source=an_12345678901",
"error": ""
}
]
}
| Field | Ý nghĩa |
|---|---|
| account | Tài khoản đã dùng để tạo link — kiểm tra aff_id đúng người nhận hoa hồng. |
| data[] | Mỗi link đầu vào một phần tử, đúng thứ tự gửi lên. Mỗi phần tử có ok/error riêng — 1 link hỏng không làm hỏng cả lô. |
| short_link | Link để chia sẻ. Rỗng khi ok=false. |
| long_link | Link dài tương ứng (để lưu/đối chiếu, không cần dùng để chia sẻ). |
Trả {"ok":false,"error":"…"} kèm HTTP status:
| error | HTTP | Xử lý |
|---|---|---|
| invalid_api_key · unauthorized | 401 | Sai key — xem lại trang API Key. |
| missing_url · too_many_urls | 400 | Thiếu link, hoặc quá 5 link (max cho biết trần). |
| no_cookie_account | 404 | Chưa có tài khoản còn cookie, hoặc aff_id/account_id không thuộc bạn. |
| cookie_expired | 422 | Sàn báo hết phiên — tài khoản tự tắt; dán cookie mới rồi gọi lại. |
| rate_limited | 429 | Quá 30 request/phút/key (= 150 link/phút khi gửi 5 link/lần). Chờ theo header Retry-After. |
| shopee_error | 502 | Sàn từ chối tạm thời — thử lại sau vài phút. |
| server_error | 500 | Lỗi phía addlivetag — báo lại kèm thời điểm gọi. |
data[].error)| error | Ý nghĩa |
|---|---|
| unsupported_url | Không phải link Sàn Cam. |
| dead_link | Link rút gọn đã chết (sàn chuyển về trang lỗi). |
| fail_code:N | Sàn từ chối link này — thường là sản phẩm/shop không nằm trong chương trình affiliate. |
Nếu bạn cấu hình affiliate ở shp.today, dùng endpoint riêng của shp.today với key dạng st_… (tạo ở trang Cấu hình affiliate của shp.today, chỉ hiện 1 lần). Trả về 1 dòng text là link; lỗi bắt đầu bằng Error. Giới hạn 60 request/phút/key, 1 link/request.
curl -H "X-API-Key: st_xxx" \ "https://shp.today/create-link.php?api=1&link_type=cookie&sub1=fb&url=https://shopee.vn/product/123/456"