API publique

Les dates des fêtes du monde francophone en JSON. Gratuite, sans clé, sans inscription. Elle sert exactement les mêmes données que le site.

Points d’entrée

GET /api/v1/aujourd-hui

Les prénoms et les fêtes du jour dans un pays.

Paramètres : pays

GET /api/v1/fetes/{slug}

Les dates d’une fête sur six ans, occurrences régionales comprises.

Paramètres : pays, annee (facultatif)

GET /api/v1/prenoms/{slug}

Fiche d’un prénom : fête, saints, popularité locale, formes apparentées.

Paramètres : pays

Une fête n’a pas une date, elle a des règles. La fête des pères tombe en juin dans la plupart des pays, le 19 mars à Anvers et au Tessin, le premier dimanche d’octobre au Luxembourg. Le champ region distingue une occurrence régionale d’une date nationale : ne les confondez pas.
Le calendrier civil des prénoms n’existe qu’en France. Ailleurs, feteLocale vaut null et les dates renvoyées sont celles du calendrier des saints, signalées par origine: "calendrier-des-saints". Les publier comme des dates locales serait faux.
Un cumul de naissances n’est pas une population. porteursVivants n’est renseigné que pour la Belgique et la Suisse, seuls pays à publier cette donnée. Le Luxembourg ne publie qu’un rang, sans effectif.

60 appels par minute et par adresse. Au-delà, la réponse est un 429 avec le délai d’attente.
Données sous CC BY 4.0 : libres de réutilisation, y compris commerciale, à condition de citer dates-des-fetes.com par un lien.
Les sources d’origine (Wikidata, INSEE, Statbel, OFS, Retraite Québec, CTIE) ont leurs propres licences, détaillées sur la page des sources.
Pas d’engagement de disponibilité. Mettez les réponses en cache : elles changent au plus une fois par jour.

Pour afficher la fête du jour sans écrire de code, le widget embarquable fait le même travail en une ligne de HTML.