← Världsdata

Kontrollera shoppinghelgdag

GET /shopping/check

Kontrollera om idag är en shoppinghelgdag eller reaevenemang i ett specifikt land. Returnerar ett booleskt resultat tillsammans med evenemangsdetaljer om det är aktivt. Användbart för att utlösa automatiserade reabanners, skicka push-notiser om pågående erbjudanden och justera prissättningsstrategier under stora shoppingevenemang som Black Friday.

Parametrar

country obligatorisk

Country

Exempelförfrågningar

Grundläggande användning
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"

Livesvar

{
  "active_events": [],
  "country": "US",
  "date": "2026-10-03",
  "days_until_next": 39,
  "is_shopping_holiday": false,
  "next_event": {
    "category": "ecommerce",
    "countries": [
      "CN",
      "SG",
      "MY",
      "TH",
      "ID",
      "PH",
      "GLOBAL"
    ],
    "date": "2026-11-11",
    "days_until": 39,
    "description": "World's largest shopping event. Originated on Alibaba. Now global. $100B+ in sales.",
    "duration_days": 1,
    "end_date": "2026-11-11",
    "id": "singles_day",
    "impact": "very_high",
    "is_active": false,
    "name": "Singles' Day (11.11)",
    "status": "upcoming"
  },
  "success": true
}