← 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-07-07",
  "days_until_next": 8,
  "is_shopping_holiday": false,
  "next_event": {
    "category": "ecommerce",
    "countries": [
      "GLOBAL"
    ],
    "date": "2026-07-15",
    "days_until": 8,
    "description": "Amazon's massive sale event. Competitors run parallel sales. Typically mid-July.",
    "duration_days": 2,
    "end_date": "2026-07-16",
    "id": "prime_day",
    "impact": "very_high",
    "is_active": false,
    "name": "Amazon Prime Day",
    "status": "coming_this_month"
  },
  "success": true
}
← Tagasi: Maailma andmed