Qual API de feriados usar em produção? Comparamos a cobertura municipal de cada uma

Testamos as principais APIs de feriados do mercado brasileiro contra a nossa base. Em praticamente todos os municípios fora das capitais, as alternativas simplesmente não têm dado municipal. Os números abaixo explicam por que isso quebra software em produção.

Quando uma empresa de RH, logística ou agendamento decide trocar a lista estática de feriados por uma API, a comparação inicial costuma ser feita pelo preço e pelo número de requisições. Mas o que importa de verdade em produção é uma pergunta que poucos comparativos respondem: quantos municípios brasileiros essa API realmente cobre com dado municipal específico?

Neste post, comparamos a Feriados API com as principais alternativas usando uma metodologia simples e auditável. Os números abaixo são todos verificáveis por qualquer leitor que tenha uma chave de cada provedor.

Como medimos

A comparação avaliou três frentes objetivas:

• Cobertura municipal: quantos feriados municipais específicos cada API entrega no agregado de 2026.
• Profundidade nas capitais: média de feriados municipais retornados para as 27 capitais (cidades que toda API costuma cobrir, então a comparação é justa).
• Classificação jurídica: se a resposta diferencia feriado NACIONAL, ESTADUAL, MUNICIPAL e FACULTATIVO, ou se trata tudo como um bloco único.

Para a Feriados API, contamos diretamente do banco de produção via SQL agregado e deduplicado por data. Para a concorrente paga direta, fizemos três coisas: (1) requisições com chave válida em 12 cidades amostradas (4 em SP, PR e RJ); (2) consulta a um endpoint público de estatísticas da própria concorrente, que retorna o tamanho auto-reportado da base; e (3) inspeção da resposta retornada para confirmar o padrão de cobertura. Para as opções gratuitas (BrasilAPI, IBGE), avaliamos a cobertura pela documentação pública.

Volume de dado municipal entregue

O gráfico abaixo mostra, em escala, quantos feriados municipais específicos cada provedor entrega em 2026 (não só os nacionais empacotados).

Volume total de feriados municipais retornados nas consultas de 2026. APIs gratuitas como BrasilAPI cobrem apenas feriados nacionais, sem nenhum recorte municipal.

Profundidade nas capitais (terreno mais favorável à concorrência)

As capitais são o cenário em que toda API tenta competir. Ainda assim, mesmo nesse recorte favorável a concorrentes, a Feriados API entrega mais. Abaixo, as 10 capitais com maior diferença em número de feriados municipais únicos retornados para 2026.

A diferença na prática: Campinas

Imagine que sua empresa tem um colaborador em Campinas, terceira maior cidade de São Paulo, com mais de 1,1 milhão de habitantes. Em 2026, Campinas tem três feriados municipais oficiais (Sexta-feira Santa, Corpus Christi e Nossa Senhora da Conceição). A resposta da Feriados API retorna todos os três, classificados corretamente:

// Resposta para Campinas (IBGE 3509502) na Feriados API
{
  "cidade": { "ibge": 3509502, "nome": "Campinas", "uf": "SP" },
  "ano": "2026",
  "feriados": [
    { "data": "01/01/2026", "nome": "Ano Novo", "tipo": "NACIONAL" },
    { "data": "03/04/2026", "nome": "Sexta-feira Santa", "tipo": "MUNICIPAL" },
    { "data": "21/04/2026", "nome": "Tiradentes", "tipo": "NACIONAL" },
    { "data": "04/06/2026", "nome": "Corpus Christi", "tipo": "MUNICIPAL" },
    { "data": "20/11/2026", "nome": "Consciência Negra", "tipo": "NACIONAL" },
    { "data": "08/12/2026", "nome": "Nossa Senhora da Conceição", "tipo": "MUNICIPAL" }
    // ... e os demais nacionais e estaduais SP
  ]
}

A resposta da concorrente direta para a mesma cidade traz apenas os feriados nacionais. Nenhum feriado municipal de Campinas aparece, mesmo a API tendo aceitado o parâmetro de localidade sem erro:

// Resposta da concorrente para a mesma cidade
{
  "feriados": [
    { "data": "01/01/2026", "nome": "Confraternização Universal", "tipo": "NACIONAL" },
    { "data": "21/04/2026", "nome": "Tiradentes", "tipo": "NACIONAL" }
    // Apenas feriados nacionais. Nenhum feriado municipal de Campinas.
  ]
}

O problema disso em produção: seu sistema vai marcar 8 de dezembro como dia útil em Campinas, agendar consulta no Dia de Nossa Senhora da Conceição (padroeira da cidade), calcular folha sem o adicional de feriado. Tudo silenciosamente errado, porque a API respondeu HTTP 200.

Por que dado municipal é o gargalo de todas as APIs

A resposta é simples: feriado municipal não está em nenhuma base pública unificada. Cada uma das 5.570 prefeituras brasileiras decreta seus próprios feriados via lei municipal, que precisa ser lida no Diário Oficial daquele município. Não existe API do governo federal que devolva isso. Não existe planilha do IBGE com essa informação.

Para construir cobertura municipal real no Brasil inteiro, o trabalho é manual e contínuo: monitorar diários, validar com a legislação vigente, corrigir quando uma câmara aprova uma nova lei. É por isso que APIs novas que aparecem no mercado conseguem cobrir as 27 capitais com algum esforço, mas batem no muro do dado municipal específico fora delas.

Por que a nossa base é mais completa

A base de dados que alimenta a Feriados API existe desde março de 2019. São mais de sete anos de curadoria contínua por especialistas brasileiros em legislação municipal, com auditoria refinada, classificação jurídica precisa e atualização ativa contra mudanças do Diário Oficial.

A vantagem competitiva não está no código da API. Está nos sete anos de curadoria de dado municipal que nenhum concorrente novo consegue replicar do zero. Quando uma API recém-lançada chega ao mercado prometendo cobertura nacional, ela está se propondo a refazer em meses um trabalho que levou mais de meia década para ficar onde está hoje.

Recursos exclusivos no mercado brasileiro

Além da cobertura, dois recursos seguem indisponíveis em qualquer alternativa do mercado:

Quem já roda em produção

A Feriados API hoje serve, entre outras, as operações de iFood, 99, O Boticário, Petz, ThoughtWorks, Buser, Flash, Cobli, AiQFome, FinanZero, Botmaker, Intelipost e Helppi. Empresas com volume real de requisições em produção, onde dado de feriado errado vira incidente operacional. Quando esse tipo de cliente escolhe uma API, é porque os números acima foram testados na unha.

Como decidir

Em todos os cenários, o ponto de partida sensato é o nosso plano Free. Ele cobre mais do que qualquer alternativa gratuita do mercado e permite testar a qualidade dos dados antes de qualquer compromisso. Quando o escopo crescer, a transição para um plano pago é só uma troca de chave.