← 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-10-24",
  "days_until_next": 18,
  "is_shopping_holiday": false,
  "next_event": {
    "category": "ecommerce",
    "countries": [
      "CN",
      "SG",
      "MY",
      "TH",
      "ID",
      "PH",
      "GLOBAL"
    ],
    "date": "2026-11-11",
    "days_until": 18,
    "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": "coming_this_month"
  },
  "success": true
}
← Retour à Données mondiales