API tạo link s.shopee.vn

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.

🧰 Cần chuẩn bị

🔑

1. API Key

Lấy ở addlivetag.com → API Key. Cùng key dùng cho Product Data và API đơn hàng.

🍪

2. Cookie affiliate

Dán cookie ở Tài khoản affiliate. Nhiều tài khoản thì chọn bằng aff_id.

🔗

3. Link sản phẩm

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.

🤖 Dành cho AI / LLM

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.

📮 Endpoint

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ố

Tham sốBắt buộcÝ nghĩa
url1 trong 2Một link Sàn Cam.
urls1 trong 2Tố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_idTùy chọnChọn tài khoản theo Affiliate ID. Bỏ trống = tài khoản còn cookie đầu tiên.
account_idTùy chọnChọn theo id tài khoản trên addlivetag (thay cho aff_id).
sub1 … sub5Tùy chọnSub-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ô.

Ví dụ

# 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));

Kết quả

{
  "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
accountTà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_linkLink để chia sẻ. Rỗng khi ok=false.
long_linkLink dài tương ứng (để lưu/đối chiếu, không cần dùng để chia sẻ).

⚠️ Mã lỗi

Lỗi cả request

Trả {"ok":false,"error":"…"} kèm HTTP status:

errorHTTPXử lý
invalid_api_key · unauthorized401Sai key — xem lại trang API Key.
missing_url · too_many_urls400Thiếu link, hoặc quá 5 link (max cho biết trần).
no_cookie_account404Chưa có tài khoản còn cookie, hoặc aff_id/account_id không thuộc bạn.
cookie_expired422Sà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_limited429Quá 30 request/phút/key (= 150 link/phút khi gửi 5 link/lần). Chờ theo header Retry-After.
shopee_error502Sàn từ chối tạm thời — thử lại sau vài phút.
server_error500Lỗi phía addlivetag — báo lại kèm thời điểm gọi.

Lỗi từng link (data[].error)

errorÝ nghĩa
unsupported_urlKhông phải link Sàn Cam.
dead_linkLink rút gọn đã chết (sàn chuyển về trang lỗi).
fail_code:NSà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.
🔐 Giữ key như mật khẩu. Mỗi request gọi sàn bằng phiên affiliate của chính bạn — gọi dồn dập có thể khiến sàn khoá phiên, nên đừng vượt giới hạn bằng cách xoay nhiều key. Cần link ngắn mà không muốn dùng cookie? Build link an_redir — không giới hạn, không cần gọi API.

🔁 Bản shp.today

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"