← Maailma andmed

Kontrolli ostupüha

GET /shopping/check

Kontrollige, kas täna on konkreetses riigis ostlemispüha või sooduskampaania. Tagastab tõeväärtuse tulemuse koos sündmuse üksikasjadega, kui see on aktiivne. Kasulik automaatsete soodusbännerite käivitamiseks, käimasolevate pakkumiste kohta tõuketeavituste saatmiseks ning hinnastrateegiate kohandamiseks suurte ostlemissündmuste ajal nagu 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": [],
  "country": "US",
  "date": "2026-05-22",
  "days_until_next": 3,
  "is_shopping_holiday": false,
  "next_event": {
    "category": "seasonal",
    "countries": [
      "US"
    ],
    "date": "2026-05-25",
    "days_until": 3,
    "description": "Kickoff of summer sales. Outdoor furniture, grills, travel, fashion.",
    "duration_days": 3,
    "end_date": "2026-05-27",
    "id": "memorial_day",
    "impact": "high",
    "is_active": false,
    "name": "Memorial Day Sales",
    "status": "coming_this_week"
  },
  "success": true
}
← Tagasi: Maailma andmed