API Jours fériés
API JSON gratuite pour les données de jours fériés. 199 pays, 6 langues, 2024-2030. Aucune clé API requise.
Endpoints
/api/v1/holidays Obtenir les jours fériés d'un pays et d'une année spécifiques.
Paramètres
| Paramètre | Obligatoire | Description |
|---|---|---|
country | Oui | Code pays ISO 3166-1 alpha-2 (ex. TR, US, DE) |
year | Oui | Année entre 2024-2030 |
type | Non | Filtrer par type : public, bank, observance, religious |
lang | Non | Langue : en, tr, de, es, fr, pt (par défaut : en) |
Exemple
https://holidaycalendar.pages.dev/api/v1/holidays?country=TR&year=2026&lang=tr Réponse
{
"holidays": [
{
"date": "2026-01-01",
"name": "Yılbaşı",
"type": "public"
},
{
"date": "2026-03-19",
"name": "Ramazan Bayramı Arifesi",
"type": "public"
}
],
"meta": {
"country": "TR",
"year": 2026,
"total": 16,
"types": { "public": 16 }
}
} /api/v1/countries Lister tous les pays pris en charge avec codes, noms et continent.
Paramètres
| Paramètre | Obligatoire | Description |
|---|---|---|
lang | Non | Langue pour les noms de pays (par défaut : en) |
Exemple
https://holidaycalendar.pages.dev/api/v1/countries?lang=en /api/v1/calendar/[country].ics Télécharger un fichier calendrier ICS pour un pays. Utiliser comme URL d'abonnement dans les apps de calendrier.
Paramètres
| Paramètre | Obligatoire | Description |
|---|---|---|
year | Non | Année (par défaut : année en cours) |
lang | Non | Langue pour les noms de jours fériés (par défaut : en) |
Exemple
https://holidaycalendar.pages.dev/api/v1/calendar/TR.ics?year=2026&lang=tr Démarrage rapide
Pas de clé API, pas d'inscription. Envoyez simplement une requête HTTP GET.
const res = await fetch( 'https://holidaycalendar.pages.dev/api/v1/holidays?country=US&year=2026' ); const data = await res.json(); console.log(data.holidays);
import requests
r = requests.get(
'https://holidaycalendar.pages.dev/api/v1/holidays',
params={'country': 'US', 'year': 2026}
)
holidays = r.json()['holidays'] Détails
Tous les endpoints retournent du JSON en encodage UTF-8. L'endpoint ICS retourne text/calendar.
Les réponses incluent des en-têtes Cache-Control (24 h). Les données de jours fériés changent rarement au cours d'une année.
Les requêtes cross-origin sont prises en charge. Appelez l'API directement depuis le JavaScript du navigateur.
Aucune limite stricte pour un usage raisonnable. Veuillez mettre en cache les réponses de votre côté pour les apps à fort trafic.
Questions fréquentes
L'API est-elle gratuite ?
Oui. Entièrement gratuite, sans clé API, sans inscription et sans limites d'utilisation pour un usage raisonnable.
Quels formats de données sont disponibles ?
JSON pour les endpoints jours fériés et pays, ICS (iCalendar) pour les flux de calendrier. Tout le texte est encodé en UTF-8.
Combien de pays sont pris en charge ?
199 pays et territoires sur 6 continents, avec des données de 2024 à 2030.
Puis-je l'utiliser dans des projets commerciaux ?
Oui. L'API est gratuite pour un usage personnel et commercial. Nous apprécions un lien retour, mais ce n'est pas obligatoire.
Y a-t-il une limite d'utilisation ?
Pas de limite stricte, mais veuillez mettre en cache les réponses pour les applications à fort trafic. Les réponses incluent un en-tête Cache-Control de 24 heures.