Português

API de Feriados

API JSON gratuita para dados de feriados. 199 países, 6 idiomas, 2024-2030. Sem chave de API.

Endpoints

GET /api/v1/holidays

Obter feriados de um país e ano específicos.

Parâmetros

ParâmetroObrigatórioDescrição
countrySimCódigo de país ISO 3166-1 alfa-2 (ex. TR, US, DE)
yearSimAno entre 2024-2030
typeNãoFiltrar por tipo: public, bank, observance, religious
langNãoIdioma: en, tr, de, es, fr, pt (padrão: en)

Exemplo

https://holidaycalendar.pages.dev/api/v1/holidays?country=TR&year=2026&lang=tr

Resposta

{
  "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 }
  }
}
GET /api/v1/countries

Listar todos os países suportados com códigos, nomes e continente.

Parâmetros

ParâmetroObrigatórioDescrição
langNãoIdioma para nomes de países (padrão: en)

Exemplo

https://holidaycalendar.pages.dev/api/v1/countries?lang=en
GET /api/v1/calendar/[country].ics

Baixar um arquivo de calendário ICS para um país. Use como URL de assinatura em apps de calendário.

Parâmetros

ParâmetroObrigatórioDescrição
yearNãoAno (padrão: ano atual)
langNãoIdioma para nomes de feriados (padrão: en)

Exemplo

https://holidaycalendar.pages.dev/api/v1/calendar/TR.ics?year=2026&lang=tr

Início rápido

1
Sem configuração necessária

Sem chave de API, sem cadastro. Basta enviar uma requisição HTTP GET.

2
Exemplo em JavaScript 
const res = await fetch(
  'https://holidaycalendar.pages.dev/api/v1/holidays?country=US&year=2026'
);
const data = await res.json();
console.log(data.holidays);
3
Exemplo em Python 
import requests
r = requests.get(
  'https://holidaycalendar.pages.dev/api/v1/holidays',
  params={'country': 'US', 'year': 2026}
)
holidays = r.json()['holidays']

Detalhes

Formato de resposta

Todos os endpoints retornam JSON com codificação UTF-8. O endpoint ICS retorna text/calendar.

Cache

As respostas incluem cabeçalhos Cache-Control (24 h). Os dados de feriados raramente mudam durante o ano.

CORS

Requisições cross-origin são suportadas. Chame a API diretamente do JavaScript do navegador.

Limites de uso

Sem limites rígidos para uso razoável. Por favor, armazene as respostas em cache do seu lado para apps de alto tráfego.

Perguntas frequentes

A API é gratuita?

Sim. Completamente gratuita, sem chave de API, sem cadastro e sem limites de uso para uso razoável.

Quais formatos de dados estão disponíveis?

JSON para os endpoints de feriados e países, ICS (iCalendar) para feeds de calendário. Todo o texto é codificado em UTF-8.

Quantos países são suportados?

199 países e territórios em 6 continentes, com dados de 2024 a 2030.

Posso usar em projetos comerciais?

Sim. A API é gratuita para uso pessoal e comercial. Agradecemos um link de volta, mas não é obrigatório.

Há um limite de uso?

Sem limite rígido, mas por favor armazene as respostas em cache para aplicações de alto tráfego. As respostas incluem um cabeçalho Cache-Control de 24 horas.