Lịch sale thương mại điện tử API

Các mốc bán hàng, marketing tại Việt Nam theo năm: ngày đôi, ngày lương, Tết, 8/3, 20/10, 20/11, Vu Lan, Black Friday, Online Friday, dạng JSON hoặc ICS.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/vn-sale-calendar?year=2027&kinds=tet,national_sale" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-sale-calendar?year=2027&kinds=tet,national_sale', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-sale-calendar?year=2027&kinds=tet,national_sale",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-sale-calendar?year=2027&kinds=tet,national_sale');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "year": 2027,
  "count": 5,
  "events": [
    {
      "date": "2027-01-07",
      "name": "Tết 2027 shopping season starts",
      "name_vi": "Bắt đầu mùa mua sắm Tết 2027",
      "kind": "tet",
      "industries": [
        "gift baskets",
        "F&B",
        "fashion",
        "home decor"
      ],
      "lead_days": 30,
      "weekday": "Thursday",
      "campaign_start": "2026-12-08"
    },
    {
      "date": "2027-01-30",
      "name": "Kitchen Gods Day (ông Công ông Táo)",
      "name_vi": "Ông Công ông Táo (23 tháng Chạp)",
      "kind": "tet",
      "industries": [
        "offerings",
        "F&B"
      ],
      "lead_days": 7,
      "weekday": "Saturday",
      "campaign_start": "2027-01-23"
    },
    {
      "date": "2027-02-05",
      "name": "Lunar New Year’s Eve (Giao thừa)",
      "name_vi": "Giao thừa Tết Nguyên đán",
      "kind": "tet",
      "industries": [
        "offerings",
        "F&B"
      ],
      "lead_days": 7,
      "weekday": "Friday",
      "campaign_start": "2027-01-29"
    },
    {
      "date": "2027-02-06",
      "name": "Lunar New Year (Tết 2027)",
      "name_vi": "Tết Nguyên đán 2027",
      "kind": "tet",
      "industries": [
        "gift baskets",
        "F&B",
        "fashion",
        "travel"
      ],
      "lead_days": 45,
      "note": "Most marketplaces slow down deliveries from about 7 days before Tết",
      "weekday": "Saturday",
      "campaign_start": "2026-12-23"
    },
    {
      "date": "2027-12-03",
      "name": "Online Friday (Vietnam Online Shopping Day)",
      "name_vi": "Ngày mua sắm trực tuyến Việt Nam – Online Friday",
      "kind": "national_sale",
      "industries": [
        "all marketplaces",
        "Vietnamese brands"
      ],
      "lead_days": 21,
      "estimated": true,
      "note": "Date announced by Bộ Công Thương each year; estimate = first Friday of December",
      "weekday": "Friday",
      "campaign_start": "2027-11-12"
    }
  ],
  "note": "Marketplace campaign dates (Shopee, Lazada, TikTok Shop, Tiki) follow these anchors but each platform announces its own schedule. Online Friday is announced yearly by Bộ Công Thương."
}

Ứng dụng

• Lên lịch nội dung và khuyến mãi cả năm
• Điền sẵn ngày chiến dịch trong công cụ marketing
• Nhập toàn bộ ngày sale vào lịch của team
• Kích hoạt quy tắc giá trước các ngày đôi

Hỏi đáp

API liên quan