API Jours fériés
Interrogez les jours fériés de plus de 100 pays et de n'importe quelle année en un seul appel d'API. Calcul entièrement local — aucune source de données externe, aucune surprise de rate limit.
Pas encore de clé API ?
Connectez-vous à votre compte pour créer et gérer vos clés API.
Guide d'intégration
Copiez un extrait, remplacez votre clé API, exécutez. Fonctionne avec n'importe quel client HTTP — exemples ci-dessous en cURL, JavaScript et Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringrequisISO 3166-1 alpha-2 country code US
yearintegeroptionnel4-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
}Conçu pour la planification du monde réel
Planification RH
Excluez automatiquement les jours fériés lors du calcul des soldes de congés, des cycles de paie et des plannings d'équipes dans plusieurs pays.
Calendriers de bourse
Ignorez les jours de fermeture des marchés dans les modèles financiers et les backtests. Identifiez les jours fériés bancaires qui affectent les fenêtres de règlement et de compensation.
ETA logistiques
Calculez des estimations de livraison précises en ignorant automatiquement les jours fériés dans les pays d'origine, de transit et de destination.
Automatisation n8n
Branchez-le à vos workflows n8n ou Zapier pour conditionner les actions sensibles au temps — n'envoyez pas d'e-mails ou de rapports les jours fériés nationaux.
Alternative à HolidayAPI et Nager.Date
Données de l'année en cours, planification pluriannuelle et SLA de production — sans le verrou d'année de l'offre gratuite ni le risque de fiabilité d'un projet communautaire.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Offre gratuite | Année précédente uniquement | Gratuit (sans SLA) | 100 crédits à l'inscription |
| Données de l'année en cours | Plan payant uniquement | ✓ | ✓ |
| Données des années à venir | Plan payant uniquement | ✓ (limité) | ✓ jusqu'à +10 ans |
| Données historiques (depuis 1900) | Plan payant uniquement | Partiel | ✓ depuis 1900 |
| SLA de production | Plans payants uniquement | ✗ Projet communautaire | ✓ |
| Pays couverts | ~100 | ~110 | 100+ |
| Pas de carte bancaire pour démarrer | ✗ | ✓ | ✓ |
| Crédits / requêtes expirent ? | Plan annuel | N/A | N'expirent jamais |
| Prêt pour agent IA / LLM | Partiel | Partiel | ✓ JSON natif |
Le piège de l'offre gratuite HolidayAPI
Le plan gratuit de HolidayAPI est volontairement limité à l'année calendaire précédente uniquement. Besoin de consulter les jours fériés de l'année en cours ou d'anticiper les plannings de congés 2027 ? Vous devez passer à un plan payant. Pour tout cas d'usage de planification ou d'automatisation, l'offre gratuite devient pratiquement inutile dès le premier jour.
Le risque de fiabilité de Nager.Date
Nager.Date est un projet open source maintenu par la communauté — gratuit à utiliser mais avec aucun SLA de disponibilité, aucun contrat de support et aucune garantie de pérennité. Les équipes qui ont bâti des systèmes de paie ou des pipelines logistiques dessus ont été prises au dépourvu par des indisponibilités imprévues ou des abandons. Parfait pour le prototypage ; pas pour la production.
Champs de la réponse
| Champ | Type | Description |
|---|---|---|
| data.country | string | Code pays ISO 3166-1 alpha-2 (en majuscules) |
| data.country_name | string | Nom complet du pays en anglais |
| data.year | integer | L'année calendaire interrogée |
| data.total | integer | Nombre de jours fériés dans l'année |
| data.holidays | array | Liste d'objets de jours fériés triés par date |
| data.holidays[].date | string | Date du jour férié au format YYYY-MM-DD |
| data.holidays[].name | string | Nom officiel du jour férié |
| credits_used | integer | Crédits déduits pour cette requête |
| remaining_credits | integer | Crédits restants sur votre compte |
Limites de débit
La limitation est par clé API, fenêtre glissante de 60 secondes. En cas de dépassement, vous recevez un 429 propre avec un en-tête Retry-After.
120req/min
Par clé API, par endpoint. Fenêtre glissante de 60 secondes.
3concurrent
Nombre maximal de requêtes simultanées en cours par clé API.
X-RateLimit-LimitNombre maximal de requêtes autorisées par minuteX-RateLimit-RemainingRequêtes restantes dans la fenêtre actuelleX-RateLimit-ResetSecondes avant la réinitialisation de la fenêtre actuelleRetry-AfterSecondes à attendre avant de réessayer (uniquement sur 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
}Questions fréquentes
Q : Quels pays sont pris en charge ?
R : Plus de 100 pays via la bibliothèque open source python-holidays (vacanza). Cela inclut les États-Unis, le Royaume-Uni, l'Allemagne, la France, le Japon, la Chine, l'Australie, le Canada, l'Inde, le Brésil et la majeure partie de l'Europe, de l'Asie, de l'Amérique latine et de l'Afrique. Utilisez un code ISO 3166-1 alpha-2 valide (p. ex. US, GB, DE).
Q : Jusqu'où puis-je remonter dans le passé et avancer dans le futur ?
R : Vous pouvez interroger n'importe quelle année de 1900 jusqu'à 10 ans dans le futur. Les jours fériés historiques sont calculés selon les règles en vigueur à l'époque, de sorte que les résultats reflètent les fêtes réellement observées plutôt que les règles d'aujourd'hui projetées vers le passé.
Q : Les jours fériés régionaux ou des États sont-ils inclus ?
R : Cet endpoint ne renvoie que les jours fériés nationaux. Les fêtes spécifiques à un État, une province ou une région (p. ex. les jours fériés des États américains, les jours fériés des Länder allemands) ne sont pas incluses dans la réponse par défaut. Contactez-nous si vous avez besoin de données de jours fériés au niveau des subdivisions.
Q : Les agents IA peuvent-ils l'utiliser comme outil ?
R : Oui. L'endpoint prend deux paramètres de requête (country et year) et renvoie un tableau JSON structuré — simple à définir comme outil fonction pour OpenAI, Claude, LangChain ou n'importe quel framework d'agents. Idéal pour les agents de planification qui doivent raisonner sur les jours ouvrés dans plusieurs pays.
Utilisez les Jours fériés dans Claude Code et les agents IA
Installez le skill officiel Claude Code pour interroger les jours fériés de plus de 100 pays directement dans votre agent de codage IA — dates triées, noms officiels et décomptes, en langage naturel.
Demandez naturellement à votre agent IA
Plateformes compatibles
Skill Claude Code pour l'API Jours fériés d'APIpick
Renvoie des listes de jours fériés triées par date, avec les noms officiels en anglais et les décomptes totaux, pour plus de 100 pays. Prend en charge les années de 1900 jusqu'à 10 ans dans le futur.