Festività pubbliche API
Consulta le festività per oltre 100 paesi e qualsiasi anno in una sola chiamata API. Calcolo totalmente locale — nessuna fonte di dati esterna, nessuna sorpresa sui limiti di frequenza.
Non hai una API key?
Accedi al tuo account per creare e gestire le tue API key.
Guida all'integrazione
Copia uno snippet, sostituisci la tua API key, esegui. Funziona con qualsiasi client HTTP — esempi qui sotto in cURL, JavaScript e Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringobbligatorioISO 3166-1 alpha-2 country code US
yearintegerfacoltativo4-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
}Costruita per la pianificazione reale
Pianificazione HR
Escludi automaticamente le festività nel calcolo dei saldi ferie, dei cicli di paga e dei turni in più paesi.
Calendari di borsa
Salta i giorni di chiusura nei modelli finanziari e nei backtest. Individua le festività bancarie che incidono sulle finestre di regolamento e compensazione.
ETA logistiche
Calcola stime di consegna accurate saltando automaticamente le festività nei paesi di origine, transito e destinazione.
Automazione n8n
Collegala ai flussi n8n o Zapier per regolare le azioni urgenti — evita di inviare email o report nei giorni di festa nazionale.
Alternativa a HolidayAPI e Nager.Date
Dati dell'anno corrente, pianificazione di anni futuri e uno SLA di produzione — senza il blocco dell'anno del piano gratuito o il rischio di affidabilità tipico dei progetti community.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Piano gratuito | Solo anno precedente | Gratuito (senza SLA) | 100 crediti alla registrazione |
| Dati dell'anno corrente | Solo piano a pagamento | ✓ | ✓ |
| Dati di anni futuri | Solo piano a pagamento | ✓ (limitato) | ✓ fino a +10 anni |
| Dati storici (dal 1900) | Solo piano a pagamento | Parziale | ✓ dal 1900 |
| SLA di produzione | Solo piani a pagamento | ✗ Progetto community | ✓ |
| Paesi coperti | ~100 | ~110 | 100+ |
| Nessuna carta di credito per iniziare | ✗ | ✓ | ✓ |
| I crediti / le richieste scadono? | Piano annuale | N/A | Non scadono mai |
| Pronta per agenti IA / LLM | Parziale | Parziale | ✓ JSON nativo |
La trappola del piano gratuito di HolidayAPI
Il piano gratuito di HolidayAPI è intenzionalmente limitato a solo l'anno solare precedente. Devi cercare le festività dell'anno in corso o pianificare in anticipo i calendari ferie del 2027? Devi passare a un piano a pagamento. Per qualsiasi caso d'uso di pianificazione o automazione, questo rende il piano gratuito praticamente inutile fin dal primo giorno.
Il rischio di affidabilità di Nager.Date
Nager.Date è un progetto open-source mantenuto dalla community — gratuito da usare ma con nessuno SLA di uptime, nessun contratto di supporto e nessuna garanzia di disponibilità continuata. I team che hanno costruito sistemi di paga o pipeline logistiche su di esso sono stati colti di sorpresa da interruzioni impreviste o dalla dismissione. Va bene per i prototipi; non per la produzione.
Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
| data.country | string | Codice paese ISO 3166-1 alpha-2 (maiuscolo) |
| data.country_name | string | Nome completo del paese in inglese |
| data.year | integer | L'anno solare interrogato |
| data.total | integer | Numero di festività nell'anno |
| data.holidays | array | Elenco di oggetti festività ordinati per data |
| data.holidays[].date | string | Data della festività nel formato YYYY-MM-DD |
| data.holidays[].name | string | Nome ufficiale della festività |
| credits_used | integer | Crediti scalati per questa richiesta |
| remaining_credits | integer | Crediti rimanenti nel tuo account |
Limiti di frequenza
Il throttling è per API key, con finestra mobile di 60 secondi. Al raggiungimento del limite ricevi un 429 pulito con header Retry-After.
120req/min
Per API key e per endpoint. Finestra mobile di 60 secondi.
3concurrent
Numero massimo di richieste simultanee in corso per API key.
X-RateLimit-LimitNumero massimo di richieste consentite al minutoX-RateLimit-RemainingRichieste rimanenti nella finestra correnteX-RateLimit-ResetSecondi al reset della finestra correnteRetry-AfterSecondi da attendere prima di riprovare (solo in caso di 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
}Domande frequenti
D: Quali paesi sono supportati?
R: Oltre 100 paesi tramite la libreria open-source python-holidays (vacanza). Sono inclusi USA, Regno Unito, Germania, Francia, Giappone, Cina, Australia, Canada, India, Brasile e gran parte di Europa, Asia, America Latina e Africa. Usa un codice ISO 3166-1 alpha-2 valido (es. US, GB, DE).
D: Fino a quando posso interrogare, indietro e in avanti?
R: Puoi interrogare qualsiasi anno dal 1900 fino a 10 anni nel futuro. Le festività storiche sono calcolate in base alle regole in vigore all'epoca, quindi i risultati riflettono le ricorrenze storiche effettive anziché le regole odierne proiettate all'indietro.
D: Sono incluse le festività regionali/statali?
R: Questo endpoint restituisce solo le festività nazionali. Le ricorrenze specifiche di stato, provincia o regione (es. festività statali USA, festività dei Länder tedeschi) non sono incluse nella risposta predefinita. Contattaci se ti servono dati sulle festività a livello di suddivisione.
D: Gli agenti IA possono usarla come tool?
R: Sì. L'endpoint accetta due parametri di query (country e year) e restituisce un array JSON strutturato — semplice da definire come funzione tool per OpenAI, Claude, LangChain o qualsiasi framework di agenti. Ideale per gli agenti di pianificazione che devono ragionare sui giorni lavorativi in più paesi.
Usa Festività in Claude Code e negli agenti IA
Installa la skill ufficiale per Claude Code per consultare le festività di oltre 100 paesi direttamente all'interno del tuo agente di coding IA — date ordinate, nomi ufficiali e conteggi in linguaggio naturale.
Chiedi al tuo agente IA in modo naturale
Piattaforme compatibili
Skill per Claude Code per l'API APIpick Festività
Restituisce elenchi di festività ordinati per data con i nomi ufficiali in inglese e i conteggi totali per oltre 100 paesi. Supporta anni dal 1900 fino a 10 anni in avanti.