← Maailman data

Tarkista ostotapahtuma

GET /shopping/check

Tarkista, onko tänään ostotapahtuma tai alennusmyynti tietyssä maassa. Palauttaa totuusarvon sekä tapahtumatiedot, jos aktiivinen. Hyödyllinen automaattisten alennusbannereiden käynnistämiseen ja hinnoittelustrategioiden säätämiseen suurten ostostapahtumien aikana.

Parametrit

country pakollinen

Country

Esimerkkipyynnöt

Peruskäyttö
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"

Reaaliaikainen vastaus

{
  "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
}