← Weltdaten

Shopping-Feiertag prüfen

GET /shopping/check

Prüfen Sie, ob today is a shopping holiday oder sale event in a specific country. Liefert eine boolean result along with event details if active. Nützlich für triggering automated sale banners, sending push notifications about ongoing deals, und adjusting pricing strategies during major shopping events like Black Friday.

Parameter

country erforderlich

Country

Beispielanfragen

Grundlegende Verwendung
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"

Live-Antwort

{
  "active_events": [
    {
      "category": "seasonal",
      "countries": [
        "GLOBAL"
      ],
      "date": "2026-04-03",
      "days_until": 0,
      "description": "Spring sales event. Fashion, home & garden, chocolate/confectionery.",
      "duration_days": 4,
      "end_date": "2026-04-06",
      "id": "easter_sales",
      "impact": "high",
      "is_active": true,
      "name": "Easter Sales",
      "status": "active_now"
    }
  ],
  "country": "US",
  "date": "2026-04-05",
  "days_until_next": -2,
  "is_shopping_holiday": true,
  "next_event": {
    "category": "seasonal",
    "countries": [
      "GLOBAL"
    ],
    "date": "2026-04-03",
    "days_until": 0,
    "description": "Spring sales event. Fashion, home & garden, chocolate/confectionery.",
    "duration_days": 4,
    "end_date": "2026-04-06",
    "id": "easter_sales",
    "impact": "high",
    "is_active": true,
    "name": "Easter Sales",
    "status": "active_now"
  },
  "success": true
}