Holiday API, l'API delle festività di 250 paesi che il fondatore gestisce in poche ore al mese

Holiday API fornisce agli sviluppatori le festività ufficiali e le ricorrenze di 250 paesi e 3.680 stati e province, in oltre 100 lingue, dal primo anno dopo Cristo fino al 2050 e oltre. A ottobre 2022 il fondatore Josh Sherman dichiarava 6.500 $ di ricavi ricorrenti al mese e 300 abbonati attivi, con un lavoro a tempo pieno a parte. Nel 2026 indica oltre 350 clienti paganti e scrive che il servizio richiede poche ore al mese.

Cosa fa

Molti software hanno bisogno di sapere se un giorno è festivo: un gestionale di turni, un calcolatore di consegne, un’app di prenotazioni, un sistema di buste paga. Le festività cambiano da paese a paese, da regione a regione, e alcune si spostano ogni anno, come Pasqua o le feste lunari. Mantenere a mano un elenco aggiornato è noioso e soggetto a errori.

Holiday API risolve il problema con una chiamata: si chiede un paese, un anno e una lingua, e la risposta contiene date, nomi e tipo di ricorrenza. I dati vengono generati da un sistema proprietario che li verifica di continuo, invece che da un elenco statico. Con un abbonamento attivo si possono salvare i dati in locale senza limiti, mentre il piano gratuito permette di tenerli solo 24 ore.

Chi c’è dietro

Josh Sherman è uno sviluppatore di Austin, in Texas, con 25 anni di esperienza e un blog tecnico, joshtronic.com, aggiornato ogni settimana da quasi vent’anni. Ha lasciato due volte un lavoro a sei cifre per dedicarsi a un progetto proprio. La prima volta con un social network finanziato solo da Google AdSense: arrivato a circa 15.000 $ al mese, i ricavi sono calati anche con il traffico in crescita. La seconda con un socio, dopo un colloquio non riuscito con Y Combinator, senza trovare clienti.

Holiday API è nata nel 2013 da un fastidio personale: Sherman manteneva a mano un elenco di festività per il lavoro e per un altro progetto, con un promemoria ogni autunno per l’anno successivo. All’inizio era un progetto open source con un servizio gratuito, senza account né chiavi.

Come guadagna

Abbonamenti solo annuali, pagati con carta. Il piano Countries costa 249 $ l’anno e copre le festività nazionali di 250 paesi. States & Provinces costa 399 $ e aggiunge le festività regionali. Entrambi includono un milione di richieste al mese, senza limiti di velocità, e uso commerciale.

Data	Indicatore	Fonte
2013	progetto gratuito e open source	fondatore
Ottobre 2022	6.500 $ al mese, 300 abbonati attivi, oltre 10.000 utenti attivi al mese sul piano gratuito	fondatore
2026	oltre 350 clienti paganti e 59.000 iscrizioni dal 2013, fino a 80 milioni di richieste al mese nel picco	fondatore

La svolta è arrivata dopo una conferenza di Noah Kagan, per cui Sherman lavorava. Parafrasando: «Tutti gli altri hanno i tuoi soldi, devi solo capire come farteli dare». Sherman ha reso obbligatoria la chiave di accesso, scontentando chi usava il servizio gratis, poi ha scritto agli utenti con più richieste chiedendo se avrebbero pagato. Senza un prezzo e senza una pagina di pagamento, ha chiuso la prima vendita in una settimana.

Da dove arrivano i clienti

• Utenti gratuiti: la chiave obbligatoria ha trasformato utenti anonimi in contatti. Chi usa molto il piano gratuito è il primo candidato al piano a pagamento.
• Ricerca: chi cerca «holiday API» o le festività di un paese trova le pagine per paese e la documentazione tecnica.
• Blog del fondatore: joshtronic.com, con oltre 60.000 visitatori unici al mese secondo Sherman, porta visibilità tra gli sviluppatori.

Cosa si può copiare

• Un dato noioso che tutti devono mantenere e nessuno vuole mantenere: le festività, i fusi orari, i codici postali.
• Un prezzo annuale semplice, con due piani, che si vende senza commerciali.
• Chiedere soldi presto: la prima vendita è arrivata scrivendo agli utenti più attivi, prima ancora di avere una pagina di pagamento.
• Un servizio tecnico stabile può restare un progetto parallelo e crescere lo stesso.

In Italia

Cercando «API festività italiane santo patrono» i risultati sono italiani. FestivitàItalia offre un’API in italiano che copre i 7.904 comuni ISTAT con la festa del patrono e calcola i giorni lavorativi per le stime di consegna, gratuita durante l’avvio e con licenza annuale del dataset in CSV per chi ne ha bisogno. Database Comuni Italiani vende un’anagrafica dei comuni che include santo patrono e festa patronale. Festività IT è un sito informativo con le date del calendario.

Holiday API copre l’Italia a livello nazionale e regionale, ma le feste patronali sono il punto debole delle API globali, perché cambiano comune per comune. Lo spazio italiano esiste e qualcuno lo sta già occupando. Resta margine su usi specifici: calendari delle chiusure scolastiche regionali, giorni di mercato, scadenze fiscali che slittano dopo un festivo.