← Maailma andmed

Kontrolli ostupüha

GET /shopping/check

Kontrollige whether today is a shopping holiday or sale event in a specific country. Tagastab a boolean result along with event details if active. Kasulik triggering automated sale banners, sending push notifications about ongoing deals, and adjusting pricing strategies during major shopping events like Black Friday.

Parameetrid

country kohustuslik

Country

Näidispäringud

Põhikasutus
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"

Reaalajas vastus 

{
  "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
}
← Tagasi: Maailma andmed