Государственные праздники API
Запрашивайте государственные праздники для 100+ стран и любого года за один вызов API. Полностью локальные вычисления — без внешних источников данных, без сюрпризов с лимитами запросов.
Нет API-ключа?
Войдите в аккаунт, чтобы создавать и управлять API-ключами.
Руководство по интеграции
Скопируйте сниппет, подставьте свой API-ключ, запустите. Работает в любом HTTP-клиенте — примеры ниже на cURL, JavaScript и Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringобязательныйISO 3166-1 alpha-2 country code US
yearintegerнеобязательный4-digit year (defaults to current year) 2026
curl -X GET "https://www.apipick.com/api/holidays" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "Holidays retrieved successfully",
"data": {
"country": "US",
"country_name": "United States",
"year": 2026,
"total": 11,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day"
},
{
"date": "2026-01-19",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2026-02-16",
"name": "Presidents' Day"
},
{
"date": "2026-05-25",
"name": "Memorial Day"
},
{
"date": "2026-07-03",
"name": "Independence Day (observed)"
},
{
"date": "2026-09-07",
"name": "Labor Day"
},
{
"date": "2026-10-12",
"name": "Columbus Day"
},
{
"date": "2026-11-11",
"name": "Veterans Day"
},
{
"date": "2026-11-26",
"name": "Thanksgiving Day"
},
{
"date": "2026-12-25",
"name": "Christmas Day"
}
]
},
"credits_used": 1,
"remaining_credits": 99
}Создано для реального планирования
HR-планирование
Автоматически исключайте государственные праздники при расчёте остатков отпусков, циклов начисления зарплаты и графиков смен в разных странах.
Торговые календари
Пропускайте неторговые дни в финансовых моделях и бэктестах. Выявляйте банковские праздники, влияющие на окна расчётов и клиринга.
Расчёт ETA в логистике
Рассчитывайте точные сроки доставки, автоматически пропуская праздники в странах отправления, транзита и назначения.
Автоматизация в n8n
Подключайте к процессам n8n или Zapier, чтобы управлять чувствительными ко времени действиями — не отправляйте письма или отчёты в национальные праздники.
Альтернатива HolidayAPI и Nager.Date
Данные за текущий год, планирование на будущие годы и производственный SLA — без блокировки года на бесплатном тарифе и без рисков надёжности community-проекта.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Бесплатный тариф | Только предыдущий год | Бесплатно (без SLA) | 100 кредитов при регистрации |
| Данные за текущий год | Только платный тариф | ✓ | ✓ |
| Данные за будущие годы | Только платный тариф | ✓ (ограниченно) | ✓ до +10 лет |
| Исторические данные (с 1900) | Только платный тариф | Частично | ✓ с 1900 года |
| Производственный SLA | Только платные тарифы | ✗ Community-проект | ✓ |
| Охват стран | ~100 | ~110 | 100+ |
| Старт без банковской карты | ✗ | ✓ | ✓ |
| Истекают ли кредиты / запросы? | Годовой тариф | N/A | Никогда не истекают |
| Готовность к AI-агентам / LLM | Частично | Частично | ✓ Нативный JSON |
Ловушка бесплатного тарифа HolidayAPI
Бесплатный тариф HolidayAPI намеренно ограничен только предыдущим календарным годом. Нужно узнать праздники текущего года или спланировать графики отпусков на 2027 год? Придётся перейти на платный тариф. Для любого сценария планирования или автоматизации это делает бесплатный тариф практически бесполезным с первого дня.
Риск надёжности Nager.Date
Nager.Date — это поддерживаемый сообществом проект с открытым исходным кодом: бесплатный, но без SLA по аптайму, без договора поддержки и без гарантий дальнейшей доступности. Команды, построившие на нём системы расчёта зарплаты или логистические пайплайны, не раз попадали впросак из-за неожиданных простоев или прекращения поддержки. Подойдёт для прототипирования, но не для продакшена.
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| data.country | string | Код страны ISO 3166-1 alpha-2 (в верхнем регистре) |
| data.country_name | string | Полное название страны на английском |
| data.year | integer | Запрошенный календарный год |
| data.total | integer | Число государственных праздников в году |
| data.holidays | array | Список объектов праздников, отсортированный по дате |
| data.holidays[].date | string | Дата праздника в формате YYYY-MM-DD |
| data.holidays[].name | string | Официальное название праздника |
| credits_used | integer | Кредитов списано за этот запрос |
| remaining_credits | integer | Кредитов осталось на вашем аккаунте |
Лимиты запросов
Ограничение действует на API-ключ, скользящее окно 60 секунд. При превышении вы получаете чистый 429 с заголовком Retry-After.
120req/min
На API-ключ, на эндпоинт. Скользящее окно 60 секунд.
3concurrent
Максимум одновременных активных запросов на API-ключ.
X-RateLimit-LimitМаксимум запросов в минутуX-RateLimit-RemainingОсталось запросов в текущем окнеX-RateLimit-ResetСекунд до сброса текущего окнаRetry-AfterСколько секунд ждать перед повтором (только при 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Часто задаваемые вопросы
В: Какие страны поддерживаются?
О: 100+ стран через open-source библиотеку python-holidays (vacanza). Сюда входят США, Великобритания, Германия, Франция, Япония, Китай, Австралия, Канада, Индия, Бразилия, а также большая часть Европы, Азии, Латинской Америки и Африки. Используйте корректный код ISO 3166-1 alpha-2 (например, US, GB, DE).
В: На какой период назад и вперёд можно делать запросы?
О: Можно запросить любой год с 1900 и до 10 лет вперёд. Исторические праздники рассчитываются по правилам, действовавшим в то время, поэтому результаты отражают реальные исторические даты, а не сегодняшние правила, спроецированные в прошлое.
В: Включены ли региональные/местные праздники?
О: Этот эндпоинт возвращает только национальные государственные праздники. Праздники штатов, провинций или регионов (например, праздники штатов США, праздники немецких земель) не включены в стандартный ответ. Свяжитесь с нами, если вам нужны данные о праздниках на уровне субъектов.
В: Могут ли AI-агенты использовать это как инструмент?
О: Да. Эндпоинт принимает два параметра запроса (country и year) и возвращает структурированный массив JSON — его легко определить как инструмент-функцию для OpenAI, Claude, LangChain или любого фреймворка агентов. Идеально для агентов планирования, которым нужно учитывать рабочие дни в разных странах.
Используйте государственные праздники в Claude Code и AI-агентах
Установите официальный навык для Claude Code, чтобы запрашивать государственные праздники для 100+ стран прямо внутри вашего AI-агента для кодинга — отсортированные даты, официальные названия и количество на естественном языке.
Спрашивайте у своего AI-агента на естественном языке
Совместимые платформы
Навык Claude Code для API государственных праздников APIpick
Возвращает списки праздников, отсортированные по дате, с официальными английскими названиями и общим количеством для 100+ стран. Поддерживает годы с 1900 и до 10 лет вперёд.