← Heimsgögn

Athuga verslunarfrídag

GET /shopping/check

Athugaðu hvort í dag sé verslunardagur eða útsöluviðburður í tilteknu landi. Skilar bólskri niðurstöðu ásamt upplýsingum um viðburð ef hann er virkur. Gagnlegt til að setja sjálfvirkt útsöluborð, senda push-tilkynningar um yfirstandandi tilboð og aðlaga verðlagsstefnu á meðan stórum verslunarviðburðum eins og Black Friday stendur.

Breytur

country nauðsynlegt

Country

Dæmi um fyrirspurnir

Grunnnotkun
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"

Lifandi svar 

{
  "active_events": [
    {
      "category": "seasonal",
      "countries": [
        "US",
        "CA",
        "GB",
        "DE",
        "FR"
      ],
      "date": "2026-08-01",
      "days_until": 0,
      "description": "Extended shopping season. Electronics, clothing, school supplies, dorm furnishings.",
      "duration_days": 45,
      "end_date": "2026-09-14",
      "id": "back_to_school",
      "impact": "high",
      "is_active": true,
      "name": "Back to School",
      "status": "active_now"
    }
  ],
  "country": "US",
  "date": "2026-09-03",
  "days_until_next": -33,
  "is_shopping_holiday": true,
  "next_event": {
    "category": "seasonal",
    "countries": [
      "US",
      "CA",
      "GB",
      "DE",
      "FR"
    ],
    "date": "2026-08-01",
    "days_until": 0,
    "description": "Extended shopping season. Electronics, clothing, school supplies, dorm furnishings.",
    "duration_days": 45,
    "end_date": "2026-09-14",
    "id": "back_to_school",
    "impact": "high",
    "is_active": true,
    "name": "Back to School",
    "status": "active_now"
  },
  "success": true
}
← Til baka í Heimsgögn