← 世界数据

检查购物假日

GET /shopping/check

检查今天是否为特定国家的购物假日或促销活动。返回布尔结果以及活动详情(如果有)。适用于触发自动促销横幅、发送关于进行中优惠的推送通知,以及在 Black Friday 等重大购物活动期间调整定价策略。

参数

country 必填

Country

请求示例

基本用法
curl "https://nordapi.ee/api/v1/shopping/check?country=US"
Check US shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=US"
Check Chinese shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=CN"
Check UK shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=GB"

实时响应

{
  "active_events": [],
  "country": "US",
  "date": "2026-10-24",
  "days_until_next": 18,
  "is_shopping_holiday": false,
  "next_event": {
    "category": "ecommerce",
    "countries": [
      "CN",
      "SG",
      "MY",
      "TH",
      "ID",
      "PH",
      "GLOBAL"
    ],
    "date": "2026-11-11",
    "days_until": 18,
    "description": "World's largest shopping event. Originated on Alibaba. Now global. $100B+ in sales.",
    "duration_days": 1,
    "end_date": "2026-11-11",
    "id": "singles_day",
    "impact": "very_high",
    "is_active": false,
    "name": "Singles' Day (11.11)",
    "status": "coming_this_month"
  },
  "success": true
}