Feriados Públicos API
Consulte feriados públicos de mais de 100 países e de qualquer ano em uma única chamada de API. Cálculo totalmente local — sem fontes de dados externas, sem surpresas de rate limit.
Não tem uma API key?
Faça login na sua conta para criar e gerenciar suas API keys.
Guia de integração
Copie um trecho, troque sua API key e execute. Funciona em qualquer cliente HTTP — exemplos abaixo em cURL, JavaScript e Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringobrigatórioISO 3166-1 alpha-2 country code US
yearintegeropcional4-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
}Feita para Escalas do Mundo Real
Escala de RH
Exclua automaticamente feriados públicos ao calcular saldos de férias, ciclos de folha de pagamento e escalas de turno em vários países.
Calendários de Negociação
Pule os dias sem pregão em modelos financeiros e backtests. Identifique feriados bancários que afetam janelas de liquidação e compensação.
ETAs Logísticos
Calcule estimativas de entrega precisas pulando automaticamente os feriados nos países de origem, trânsito e destino.
Automação com n8n
Conecte a fluxos do n8n ou Zapier para condicionar ações sensíveis ao tempo — não envie e-mails ou relatórios em feriados nacionais.
Alternativa ao HolidayAPI e Nager.Date
Dados do ano atual, planejamento para anos futuros e um SLA de produção — sem o bloqueio de ano do plano gratuito nem o risco de confiabilidade de projeto comunitário.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Plano gratuito | Apenas o ano anterior | Grátis (sem SLA) | 100 créditos no cadastro |
| Dados do ano atual | Somente no plano pago | ✓ | ✓ |
| Dados de anos futuros | Somente no plano pago | ✓ (limitado) | ✓ até +10 anos |
| Dados históricos (1900+) | Somente no plano pago | Parcial | ✓ desde 1900 |
| SLA de produção | Somente planos pagos | ✗ Projeto comunitário | ✓ |
| Países cobertos | ~100 | ~110 | 100+ |
| Sem cartão de crédito para começar | ✗ | ✓ | ✓ |
| Créditos / requisições expiram? | Plano anual | N/A | Nunca expiram |
| Pronta para agentes de IA / LLM | Parcial | Parcial | ✓ JSON nativo |
A armadilha do plano gratuito do HolidayAPI
O plano gratuito do HolidayAPI é intencionalmente limitado a apenas o ano-calendário anterior. Precisa consultar feriados do ano atual ou planejar com antecedência as escalas de férias de 2027? Você precisa fazer upgrade para um plano pago. Para qualquer caso de uso de escala ou automação, isso torna o plano gratuito praticamente inútil desde o primeiro dia.
O risco de confiabilidade do Nager.Date
O Nager.Date é um projeto open-source mantido pela comunidade — gratuito, mas com nenhum SLA de uptime, nenhum contrato de suporte e nenhuma garantia de disponibilidade contínua. Equipes que construíram sistemas de folha de pagamento ou pipelines logísticos sobre ele foram pegas de surpresa por indisponibilidade inesperada ou descontinuação. Ótimo para prototipar; não para produção.
Campos de Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| data.country | string | Código de país ISO 3166-1 alpha-2 (maiúsculo) |
| data.country_name | string | Nome completo do país em inglês |
| data.year | integer | O ano-calendário consultado |
| data.total | integer | Número de feriados públicos no ano |
| data.holidays | array | Lista de objetos de feriado ordenados por data |
| data.holidays[].date | string | Data do feriado no formato YYYY-MM-DD |
| data.holidays[].name | string | Nome oficial do feriado |
| credits_used | integer | Créditos deduzidos por esta requisição |
| remaining_credits | integer | Créditos restantes na sua conta |
Rate limits
O throttling é por API key, em janela deslizante de 60 segundos. Ao atingir o limite, você recebe um 429 limpo com um header Retry-After.
120req/min
Por API key, por endpoint. Janela deslizante de 60 segundos.
3concurrent
Máximo de requisições simultâneas em andamento por API key.
X-RateLimit-LimitMáximo de requisições permitidas por minutoX-RateLimit-RemainingRequisições restantes na janela atualX-RateLimit-ResetSegundos até a janela atual reiniciarRetry-AfterSegundos a aguardar antes de tentar novamente (apenas em 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
}Perguntas Frequentes
P: Quais países são suportados?
R: Mais de 100 países por meio da biblioteca open-source python-holidays (vacanza). Isso inclui EUA, Reino Unido, Alemanha, França, Japão, China, Austrália, Canadá, Índia, Brasil e a maior parte da Europa, Ásia, América Latina e África. Use um código ISO 3166-1 alpha-2 válido (ex.: US, GB, DE).
P: Até quando posso consultar, para trás e para frente?
R: Você pode consultar qualquer ano de 1900 até 10 anos no futuro. Os feriados históricos são calculados com base nas regras que estavam em vigor na época, de modo que os resultados refletem as observâncias históricas reais, e não as regras de hoje projetadas para trás.
P: Feriados regionais/estaduais são incluídos?
R: Este endpoint retorna apenas feriados públicos nacionais. Observâncias específicas de estado, província ou região (ex.: feriados estaduais dos EUA, feriados dos Länder alemães) não são incluídas na resposta padrão. Entre em contato se você precisar de dados de feriados em nível de subdivisão.
P: Agentes de IA podem usar isto como uma tool?
R: Sim. O endpoint recebe dois parâmetros de consulta (country e year) e retorna um array JSON estruturado — simples de definir como uma função tool para OpenAI, Claude, LangChain ou qualquer framework de agentes. Ideal para agentes de escala que precisam raciocinar sobre dias úteis em vários países.
Use os Public Holidays no Claude Code e em Agentes de IA
Instale a skill oficial do Claude Code para consultar feriados públicos de mais de 100 países diretamente dentro do seu agente de programação de IA — datas ordenadas, nomes oficiais e contagens, via linguagem natural.
Peça ao seu agente de IA em linguagem natural
Plataformas compatíveis
Skill do Claude Code para a API Public Holidays da APIpick
Retorna listas de feriados ordenadas por data, com nomes oficiais em inglês e contagens totais, para mais de 100 países. Suporta anos de 1900 até 10 anos à frente.