← Données mondiales

Vérifier un événement commercial

GET /shopping/check

Vérifiez si aujourd'hui correspond à un jour de soldes ou à un événement commercial dans un pays spécifique. Renvoie un résultat booléen accompagné des détails de l'événement s'il est actif. Utile pour déclencher l'affichage automatique de bannières promotionnelles, envoyer des notifications push à propos des offres en cours et ajuster les stratégies tarifaires lors des grands événements commerciaux comme le Black Friday.

Paramètres

country requis

Country

Exemples de requêtes

Utilisation de base
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"

Réponse en direct 

{
  "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
}
← Retour à Données mondiales