← 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-11-22",
  "days_until_next": 4,
  "is_shopping_holiday": false,
  "next_event": {
    "category": "seasonal",
    "countries": [
      "US"
    ],
    "date": "2026-11-26",
    "days_until": 4,
    "description": "Start of the US holiday shopping season. Food, cooking, entertainment.",
    "duration_days": 1,
    "end_date": "2026-11-26",
    "id": "thanksgiving",
    "impact": "high",
    "is_active": false,
    "name": "Thanksgiving Sales",
    "status": "coming_this_week"
  },
  "success": true
}