Flash Sale API có miễn phí không?

Flash Sale API yêu cầu API key cho tất cả endpoint. Giá từ 50.000đ/30 ngày. Liên hệ Telegram @nam250894 để mua token.

API key Flash Sale giá bao nhiêu?

50.000đ/30 ngày hoặc 250.000đ/180 ngày (tiết kiệm 50.000đ). Rate limit 30 req/phút.

Làm sao truyền API key?

Qua header X-Api-Key, query parameter api_key, hoặc header Authorization: Bearer .

⚡ Flash Sale API

Dữ liệu Flash Sale real-time từ Shopee, Lazada & Tiki. Miễn phí cho endpoint cơ bản — API key cho dữ liệu nâng cao.

🔑 Pro: 30 req/phút

🔑 API Key (cho Pro endpoints)

Key sẽ được gửi qua header X-Api-Key khi bấm "Chạy". Chưa có key? Mua tại đây

🔐 Xác thực

🔑 Xác thực API Key

Tất cả endpoint Flash Sale đều yêu cầu API key. Truyền qua một trong 3 cách:

X-Api-Key: YOUR_KEY (header)
api_key=YOUR_KEY (query param)
Authorization: Bearer YOUR_KEY (header)

Rate limit: 30 req/phút per token.

💰 Bảng giá Pro

PHỔ BIẾN

Tháng

50kđ

30 ngày

30 req/phút
Toàn bộ Pro endpoints
Shopee + Lazada + Tiki

TIẾT KIỆM

6 tháng ⭐

250kđ

180 ngày · ~41.700đ/tháng

30 req/phút
Toàn bộ Pro endpoints
Ưu tiên hỗ trợ

🎁 Tiết kiệm 50.000đ

🔐 Chung 1 token cho mọi gói — liên hệ @nam250894 để nhận.

📑 Mục lục Endpoints

🌐 Đa nền tảng (Cross-platform)

GET /flash-sale/all PRO GET /flash-sale/status PRO

🛍️ Shopee

GET /flash-sale/promotions PRO GET /flash-sale/products PRO GET /flash-sale/top PRO GET /flash-sale/search PRO

🛒 Lazada

GET /lazada/items PRO GET /lazada/products PRO GET /lazada/top PRO GET /lazada/search PRO

🏪 Tiki

GET /tiki/sessions PRO GET /tiki/items PRO GET /tiki/search PRO GET /tiki/top PRO GET /tiki/products PRO

📊 Khác

GET /deals PRO GET /stats PRO

🌐 Đa nền tảng (Cross-platform)

GET/flash-sale/all🔑 PRO

Tìm kiếm thống nhất đa nền tảng — Shopee + Lazada + Tiki trong 1 request. Lọc theo giá, % giảm, sắp xếp, phân trang.

Tham số

Tên	Kiểu		Mô tả
keyword	string	optional	Từ khóa tìm kiếm
platform	string	optional	shopee · lazada · tiki · all. Mặc định: all
sort	string	optional	discount · price · price_desc · sold · rating. Mặc định: discount
min_discount	number	optional	% giảm tối thiểu
max_price	number	optional	Giá tối đa (VNĐ)
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Response

JSON

{
  "ok": true,
  "items": [{
    "name": "...", "price": 10000, "original_price": 50000,
    "discount_percent": 80, "image": "...", "url": "...",
    "sold": 5, "stock": 10, "rating": 4.5, "review_count": 100,
    "shop": "...", "brand": "...", "platform": "shopee"
  }],
  "total": 500, "page": 1, "per_page": 20, "has_more": true,
  "platforms": { "shopee": 200, "lazada": 150, "tiki": 150 },
  "timestamp": 1700000000
}

Thử ngay

/api/v1/flash-sale/all?keyword=iphone&per_page=3

GET/flash-sale/status🔑 PRO

Kiểm tra trạng thái & sức khỏe các nền tảng. Số lượng item, sessions, nguồn dữ liệu.

Tham số

✨Không cần tham số

Response

JSON

{
  "ok": true,
  "platforms": {
    "shopee": { "status": "ok", "items": 688, "sessions": 5, "active_sessions": 1, "source": "shopee-api-direct" },
    "lazada": { "status": "ok", "items": 800, "source": "hupvoi-api" },
    "tiki": { "status": "ok", "items": 3889, "sessions": 4, "active_sessions": 0, "source": "tiki-api-direct" }
  },
  "timestamp": 1700000000
}

Thử ngay

/api/v1/flash-sale/status

🛍️ Shopee Flash Sale API

GET/flash-sale/promotions🔑 PRO

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": 1700000000, "end_time": 1700014400, "status": "active" }
  ],
  "meta": { "total": 5, "active": 1, "upcoming": 2, "ended": 2, "timestamp": 1700000000 }
}

Thử ngay

/api/v1/flash-sale/promotions

GET/flash-sale/products🔑 PRO

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.

Tham số

Tên	Kiểu		Mô tả
promotion_id	number	optional	ID khung sale
keyword	string	optional	Tìm theo tên SP
sort	string	optional	discount · price · price_desc
in_stock	string	optional	Chỉ còn hàng: true
max_price	number	optional	Giá tối đa (VNĐ)
page	number	optional	Mặc định: 1
per_page	number	optional	1–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🔑 PRO

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

Tham số

Tên	Kiểu		Mô tả
limit	number	optional	1–50. Mặc định: 10

Response

JSON

{
  "ok": true,
  "data": [{
    "id": 45202203887, "name": "...",
    "price": 10000, "original_price": 80000, "discount_pct": 87,
    "stock": 5, "total_stock": 20,
    "image": "...", "url": "...", "shop_name": "..."
  }],
  "meta": { "count": 10, "promotion_id": "...", "timestamp": 1700000000 }
}

Thử ngay

/api/v1/flash-sale/top?limit=5

GET/flash-sale/search🔑 PRO

Tìm kiếm sản phẩm trong Flash Sale Shopee theo từ khóa. Response giống /products.

Tham số

Tên	Kiểu		Mô tả
keyword	string	required	Từ khóa
sort	string	optional	discount · price · price_desc
in_stock	string	optional	Chỉ còn hàng: true
max_price	number	optional	Giá tối đa (VNĐ)
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Thử ngay

/api/v1/flash-sale/search?keyword=iphone

🛒 Lazada API

GET/lazada/items🔑 PRO

Danh sách deal Lazada với phân trang. Yêu cầu API key.

Tham số

Tên	Kiểu		Mô tả
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Thử ngay

/api/v1/lazada/items?per_page=3

GET/lazada/products🔑 PRO

Lấy danh sách sản phẩm Lazada deal — structured, filtered, paginated.

Tham số

Tên	Kiểu		Mô tả
keyword	string	optional	Tìm theo tên SP
sort	string	optional	discount · price · price_desc · sold · rating
in_stock	string	optional	Chỉ còn hàng: true
max_price	number	optional	Giá tối đa (VNĐ)
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Response

JSON

{
  "ok": true,
  "data": [{
    "id": "...", "name": "...",
    "price": 120000, "original_price": 500000, "discount_pct": 76,
    "sold": 50, "rating": 4.8,
    "image": "...", "url": "...",
    "is_official": true, "shop_name": "...", "brand": "Samsung"
  }],
  "meta": { "total": 800, "page": 1, "per_page": 20, "total_pages": 40 }
}

Thử ngay

/api/v1/lazada/products?per_page=3&sort=discount

GET/lazada/top🔑 PRO

Top N deal Lazada giảm sâu nhất.

Tham số

Tên	Kiểu		Mô tả
limit	number	optional	1–50. Mặc định: 10

Thử ngay

/api/v1/lazada/top?limit=5

GET/lazada/search🔑 PRO

Tìm kiếm sản phẩm Lazada theo từ khóa. Response giống /lazada/products.

Tham số

Tên	Kiểu		Mô tả
keyword	string	required	Từ khóa tìm kiếm
sort	string	optional	discount · price · price_desc · sold · rating
in_stock	string	optional	Chỉ còn hàng: true
max_price	number	optional	Giá tối đa (VNĐ)
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Thử ngay

/api/v1/lazada/search?keyword=tai+nghe&per_page=3

🏪 Tiki Flash Sale API

GET/tiki/sessions🔑 PRO

Danh sách khung giờ Flash Sale Tiki. Lấy time_id để query sản phẩm theo khung cụ thể. Yêu cầu API key.

Tham số

✨Không cần tham số

Thử ngay

/api/v1/tiki/sessions

GET/tiki/items🔑 PRO

Danh sách deal Tiki. Yêu cầu API key.

Tham số

Tên	Kiểu		Mô tả
time_id	number	optional	ID khung giờ (xem /tiki/sessions)
per_page	number	optional	Số item trả về

Thử ngay

/api/v1/tiki/items?per_page=3

GET/tiki/search🔑 PRO

Tìm kiếm sản phẩm Tiki deal theo từ khóa. Yêu cầu API key.

Tham số

Tên	Kiểu		Mô tả
keyword	string	required	Từ khóa tìm kiếm
time_id	number	optional	ID khung giờ
per_page	number	optional	Số item trả về

Thử ngay

/api/v1/tiki/search?keyword=sach&per_page=3

GET/tiki/top🔑 PRO

Top N deal Tiki giảm sâu nhất. Yêu cầu API key.

Tham số

Tên	Kiểu		Mô tả
limit	number	optional	1–50. Mặc định: 10

Thử ngay

/api/v1/tiki/top?limit=5

GET/tiki/products🔑 PRO

Lấy danh sách sản phẩm Tiki deal — structured, filtered, paginated. Yêu cầu API key.

Tham số

Tên	Kiểu		Mô tả
keyword	string	optional	Tìm theo tên SP
sort	string	optional	discount · price · price_desc
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Thử ngay

/api/v1/tiki/products?per_page=3&sort=discount

📊 Khác

GET/deals🔑 PRO

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ên	Kiểu		Mô tả
q	string	optional	Tìm theo tên
source	string	optional	Shopee · Lazada · Tiki
days	number	optional	1–365. Mặc định: 30
page	number	optional	Mặc định: 1
per_page	number	optional	1–50. Mặc định: 20

Thử ngay

/api/v1/deals?per_page=3&days=7

GET/stats🔑 PRO

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.

Tham số

✨Không cần tham số

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

🏦 Lãi suất tiết kiệm

GET/savings-rate🔑 PRO

Lấy lãi suất gửi tiết kiệm VND từ các ngân hàng lớn Việt Nam: Vietcombank, BIDV, VietinBank, Agribank, TPBank, VPBank, ACB, MB Bank. Theo kỳ hạn: không kỳ hạn, 1 tháng, 3 tháng, 6 tháng, 12 tháng. Cached 15 phút.

Tham số

Tên	Kiểu		Mô tả
bank	string	optional	Lọc theo ngân hàng: vietcombank · bidv · vietinbank · agribank · tpbank · vpbank · acb · mb
term	string	optional	Lọc theo kỳ hạn: 0 (không kỳ hạn) · 1 (1 tháng) · 3 · 6 · 12
force	number	optional	Bypass cache: 1

Response

JSON

{
  "success": true,
  "updated_at": "2026-05-09T18:10:00+07:00",
  "updated_date": "09/05/2026",
  "note": "Lãi suất tiết kiệm VND thông thường, không kỳ hạn/tính theo tháng...",
  "items": [
    { "term": "1 tháng", "rate": 1.6, "bank": "Vietcombank", "unit": "%/năm" },
    { "term": "3 tháng", "rate": 1.9, "bank": "Vietcombank", "unit": "%/năm" },
    { "term": "6 tháng", "rate": 2.9, "bank": "Vietcombank", "unit": "%/năm" },
    { "term": "12 tháng", "rate": 4.7, "bank": "Vietcombank", "unit": "%/năm" }
  ],
  "sources": [{ "bank": "Vietcombank", "ok": true }, ...],
  "total_items": 47,
  "cache_policy": "static_15min"
}

Thử ngay

/api/v1/savings-rate

💻 Code Examples

JavaScript

const res = await fetch('https://keoquy.com/api/v1/flash-sale/all?keyword=iphone&per_page=5', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});
const { items } = await res.json();
items.forEach(d => console.log(`[${d.platform}] -${d.discount_percent}% ${d.name}`));

JavaScript (Top deals)

const res = await fetch('https://keoquy.com/api/v1/flash-sale/top?limit=5', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});
const { data } = await res.json();
data.forEach(d => console.log(`-${d.discount_pct}% ${d.name} → ${d.price}đ`));

Python

import requests

headers = {"X-Api-Key": "YOUR_API_KEY"}

# Status
data = requests.get("https://keoquy.com/api/v1/flash-sale/status", headers=headers).json()
print(data["platforms"])

# Top deals
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

# Cross-platform search
curl -H "X-Api-Key: YOUR_API_KEY" "https://keoquy.com/api/v1/flash-sale/all?keyword=iphone&per_page=3"

# Top deals
curl -H "X-Api-Key: YOUR_API_KEY" "https://keoquy.com/api/v1/flash-sale/top?limit=3"

⚠️ Error codes

Error response format

JSON

{
  "ok": false,
  "error": "Error message here"
}

401

API key thiếu hoặc sai. Tất cả endpoint đều yêu cầu API key. Kiểm tra header X-Api-Key hoặc query api_key

429

Rate limit. Vượt 30 req/phút per token. Chờ rồi thử lại

502

Upstream error. Nền tảng tạm lỗi (Shopee/Lazada/Tiki), thử lại sau vài giây

🔑 Nâng cấp Pro

Truy cập toàn bộ endpoints nâng cao · Shopee + Lazada + Tiki · Hỗ trợ nhanh qua Telegram

📲 @nam250894