REST API · v2.0

KeoQuy API

Dữ liệu Flash Sale, Giá Vàng, Xăng Dầu & Tỷ Giá — miễn phí, JSON, CORS-ready.

Base URL https://keoquy.com/api/v1

🔓 CORS enabled 📦 JSON response ⚡ Cache tự động 📖 Docs đầy đủ

Flash Sale

Dữ liệu Flash Sale Shopee real-time — khung giờ, sản phẩm, top deal, tìm kiếm theo keyword.

Giá Vàng

SJC, DOJI, PNJ và XAU/USD thế giới. Cập nhật mỗi 5 phút từ các nguồn uy tín.

Giá Xăng Dầu

RON 95, E5, DO, Dầu hỏa — nguồn PVOIL, cập nhật theo kỳ điều chỉnh.

Tỷ Giá

Tỷ giá Vietcombank — USD, EUR, JPY, GBP và 20+ ngoại tệ. Cập nhật mỗi 5 phút.

🔐 Xác thực

Authorization: Bearer <token>

Gold, Fuel, Exchange Rate — không cần token
Flash Sale — cần Bearer token

💬 Liên hệ nhận token →

⚡ Rate Limit

Flash Sale

30 req/min
token required

Gold

120 req/min
cache 5 phút

Fuel

120 req/min
cache theo kỳ

Exchange Rate

120 req/min
cache 5 phút

Vượt giới hạn → HTTP 429 · Retry-After header

💻 Ví dụ nhanh

# Giá vàng hiện tại
curl https://keoquy.com/api/v1/gold

# Giá xăng dầu
curl https://keoquy.com/api/v1/fuel

# Tỷ giá ngoại tệ
curl https://keoquy.com/api/v1/exchange-rate

# Flash Sale (cần token)
curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://keoquy.com/api/v1/flashsale/promotions