Flash Sale API

Dữ liệu Flash Sale Shopee & Lazada — khung giờ, sản phẩm, top deal, tìm kiếm. Yêu cầu API key.

🔑 API Key required ⚡ 30 req/phút/token
💰 Bảng giá
PHỔ BIẾN
Tháng
50kđ
30 ngày · Không giới hạn
  • 30 req/phút
  • Toàn bộ Flash Sale API
  • Bot, app thương mại
TIẾT KIỆM 17%
6 tháng ⭐
250kđ
180 ngày · ~41.700đ/tháng
  • 30 req/phút
  • Toàn bộ Flash Sale API
  • Ưu tiên hỗ trợ
🎁 Tiết kiệm 50.000đ
🔐 Chung 1 endpoint & token cho mọi gói — liên hệ @nam250894 để nhận.
Endpoints
🛍️ Shopee
GET /flash-sale/promotions GET /flash-sale/products GET /flash-sale/top GET /flash-sale/search
🛒 Lazada
GET /lazada/products GET /lazada/top GET /lazada/search
📊 Khác
GET /deals GET /stats
🛍️ Shopee Flash Sale API
GET/flash-sale/promotions

Lấy danh sách tất cả khung giờ Flash Sale Shopee trong ngày. Trạng thái: active · upcoming · ended

Tham số
Không cần tham số
Response
JSON
{
  "ok": true,
  "data": [
    { "promotion_id": 243196764962821, "start_time": 1773453600, "end_time": 1773464400, "status": "active" }
  ],
  "meta": { "count": 5, "timestamp": 1773455000 }
}
Thử ngay
/api/v1/flash-sale/promotions
GET/flash-sale/products

Lấy danh sách sản phẩm Flash Sale Shopee — lọc theo giá, % giảm, còn hàng, phân trang. Mặc định lấy khung active.

Tham số
TênKiểuMô tả
promotion_idnumberoptionalID khung sale
keywordstringoptionalTìm theo tên SP
sortstringoptionaldiscount · price · price_desc
in_stockstringoptionalChỉ còn hàng: true
max_pricenumberoptionalGiá tối đa (VNĐ)
pagenumberoptionalMặc định: 1
per_pagenumberoptional1–50. Mặc định: 20
Response
JSON
{
  "ok": true,
  "data": [{
    "id": 52756521482, "name": "Tranh dán tường 30x40cm",
    "price": 10000, "original_price": 160000, "discount_pct": 94,
    "stock": 12, "image": "https://cf.shopee.vn/...", "url": "https://shopee.vn/..."
  }],
  "meta": { "total": 156, "page": 1, "per_page": 20, "total_pages": 8 }
}
Thử ngay
/api/v1/flash-sale/products?per_page=3&sort=discount&in_stock=true
GET/flash-sale/top

Top N deal Shopee giảm sâu nhất đang còn hàng. Gọi 1 lần là có danh sách deal hot nhất.

Tham số
TênKiểuMô tả
limitnumberoptional1–50. Mặc định: 10
Thử ngay
/api/v1/flash-sale/top?limit=5
🛒 Lazada API
GET/lazada/products

Lấy danh sách sản phẩm Lazada deal — lọc theo giá, % giảm, rating, phân trang. Dữ liệu cập nhật mỗi 5 phút.

Tham số
TênKiểuMô tả
keywordstringoptionalTìm theo tên SP
sortstringoptionaldiscount · price · price_desc · sold · rating
in_stockstringoptionalChỉ còn hàng: true
max_pricenumberoptionalGiá tối đa (VNĐ)
min_discountnumberoptional% giảm tối thiểu
pagenumberoptionalMặc định: 1
per_pagenumberoptional1–50. Mặc định: 20
Response
JSON
{
  "ok": true,
  "data": [{
    "id": 3847291056, "name": "Tai nghe Bluetooth TWS",
    "price": 89000, "original_price": 350000, "discount_pct": 75,
    "sold": 1200, "rating": 4.8, "is_official": true,
    "image": "https://...", "url": "https://lazada.vn/..."
  }],
  "meta": { "total": 85, "page": 1, "per_page": 20, "total_pages": 5, "platform": "lazada" }
}
Thử ngay
/api/v1/lazada/products?per_page=3&sort=discount
GET/lazada/top

Top N deal Lazada giảm sâu nhất đang còn hàng.

Tham số
TênKiểuMô tả
limitnumberoptional1–50. Mặc định: 10
Thử ngay
/api/v1/lazada/top?limit=5
📊 Khác
GET/deals

Deal do cộng đồng Kèo Quỷ chia sẻ trên Telegram — Shopee, Lazada, Tiki và các nguồn khác.

Tham số
TênKiểuMô tả
qstringoptionalTìm theo tên
sourcestringoptionalShopee · Lazada · Tiki
daysnumberoptional1–365. Mặc định: 30
pagenumberoptionalMặc định: 1
per_pagenumberoptional1–50. Mặc định: 20
Thử ngay
/api/v1/deals?per_page=3&days=7
GET/stats

Thống kê tổng quan: thành viên Telegram, deal theo ngày/tuần/tháng, phân bố theo nguồn.

Response
JSON
{
  "ok": true,
  "data": {
    "telegram_members": 1250, "deals_today": 15, "deals_7d": 89,
    "deals_30d": 312, "deals_total": 432,
    "sources": { "Shopee": 280, "Lazada": 120, "Tiki": 32 }
  }
}
Thử ngay
/api/v1/stats
💻 Code Examples
JavaScript
const res = await fetch('https://keoquy.com/api/v1/flash-sale/top?limit=5', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const { data } = await res.json();
data.forEach(d => console.log(`-${d.discount_pct}% ${d.name} → ${d.price}đ`));
Python
import requests

headers = {"Authorization": "Bearer YOUR_TOKEN"}
data = requests.get("https://keoquy.com/api/v1/flash-sale/top?limit=5", headers=headers).json()["data"]

for d in data:
    print(f"-{d['discount_pct']}% {d['name']} → {d['price']:,}đ")
cURL
curl -H "Authorization: Bearer YOUR_TOKEN" "https://keoquy.com/api/v1/flash-sale/promotions"

curl -H "Authorization: Bearer YOUR_TOKEN" "https://keoquy.com/api/v1/flash-sale/top?limit=3"
⚠️ Error codes
401
API key thiếu hoặc sai. Kiểm tra header Authorization: Bearer TOKEN
403
Token hết hạn / bị vô hiệu. Liên hệ @nam250894 để gia hạn
429
Rate limit. Vượt 30 req/phút. Chờ 1 phút rồi thử lại
502
Upstream error. Shopee tạm lỗi, thử lại sau vài giây

🔑 Mua token ngay

Truy cập toàn bộ Flash Sale API · Hỗ trợ nhanh qua Telegram

📲 @nam250894