Календар на празниците — API за бизнес въздействие Online
Моделна оценка на бизнес въздействието на празниците за търговия на дребно, логистика и планиране на търсенето (Pro и по-висок). insights оценява всеки празник от 0 до 100 с вероятността магазините да са затворени, категориите търсене, които растат преди него, позицията спрямо дълъг уикенд и мост и нашия множител на трафика по границите, плюс обобщение по държави. demand-surge връща датираните прозорци около почивните празници (преди празника, празник, след празника), всеки с интензитет. Оценките са приблизителни и се базират на типа празник, статуса на почивен ден, обхвата, позицията в календара, забраните за камиони и нашите множители на трафика — не на наблюдавани данни за продажби.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— клас квота: heavy
| Параметър | Описание |
|---|---|
op | insights (по подразбиране) | demand-surge |
country | Двубуквен ISO код на държава или списък до 10, разделени със запетая (задължително) |
year | YYYY, 2020-2035 (по подразбиране: текущата година) |
from | Начало на периода YYYY-MM-DD (заедно с to; най-много 731 дни) |
to | Край на периода YYYY-MM-DD |
region | Регион по ISO 3166-2, напр. DE-BY (по избор) |
lang | Езикови кодове за имената (по подразбиране: всички налични) |
min_impact | Само празници с impact_score поне тази стойност (0-100) |
Полета на отговора — вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
| Поле | Описание |
|---|---|
data.holidays[].id | Стабилен идентификатор на празника, напр. hol_de_christmas_day_2026 — стойността, която приема ?id=. Наблюдаваните (преместени) дни завършват на _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=понеделник..7=неделя), day_name, is_weekend (уикенд според държавата). |
data.holidays[].name | en, local (на local_lang) и translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL или REGIONAL, regions_affected (кодове по ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (изчислена дата по ислямския календар), note (suspended_martial_law, transferred_by_decree или null). |
data.holidays[].floating_logic | is_floating, rule (правило за датата в обикновен текст), shifted_from (първоначалната дата, когато празник в почивен ден е преместен). |
data.holidays[].truck_ban | Забрана за движение на камиони по празници в съответната държава: applies, time_from, time_until (местно време), min_weight_tons, eve_rule {date,time_from,time_until} за забрана в навечерието, scope_note. |
data.holidays[].business_intelligence | impact_score 0-100, retail_closure_probability 0-1, demand_surge_categories[], long_weekend, bridge_opportunity, holiday_family, border_traffic_multiplier (null, когато няма), basis model_estimated, model. |
data.summary[] | op=insights, по държави: holidays, weekday_days_off, long_weekends, average_impact_score, top_holidays[3]. |
data.windows[] | op=demand-surge: date, phase (pre_holiday | holiday | post_holiday), intensity 0-100, demand_surge_categories, retail_closure_probability (фаза holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Идентификатор на модела и бележката, че това са оценки. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/impact?op=insights&country=DE,PL&year=2026" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Обновено