Buscar nos diários oficiais
O diário oficial é onde o ato existe juridicamente: nomeação, contrato, dispensa, tudo passa por ali. O Querido Diário, da Open Knowledge Brasil, transforma diários municipais em texto buscável por API aberta. É a forma mais direta de responder "isto foi publicado, e quando".
A ressalva que define o uso
- Menção em diário é publicação, não fato apurado. O nome de uma empresa num extrato de contrato diz que houve contrato — não diz que houve irregularidade. A distância entre as duas coisas é onde mora quase todo erro de leitura de diário.
- Ausência de menção não é ausência de ato. A cobertura não é nacional: município ausente da base não é município sem diário. E busca por texto falha com erro de digitação, abreviação e documento digitalizado sem reconhecimento de caractere.
- Não é sobre pessoas. Este site não publica nada sobre pessoas, e o roteiro segue a mesma regra: o objeto é o ato, o órgão e o procedimento.
A chamada
Edições de um município, pelo código do IBGE:
https://api.queridodiario.org.br/gazettes?territory_ids=5300108&size=1
- O endereço mudou. O antigo (
queridodiario.ok.org.br/api) responde por redirecionamento, e cliente que não o segue quebra. Use o endereço novo direto. - O serviço oscila. Em 22 de setembro de 2026 respondeu 200 e, vinte minutos depois, 503. Trate a queda como esperada e tente de novo, em vez de concluir que o município não está na base.
- Parâmetros úteis:
querystringpara o termo,published_sinceepublished_untilpara o período,sizeeoffsetpara paginar. Comece comsize=1para ver a forma da resposta antes de puxar tudo. - O código do território é o do IBGE, o mesmo do Tesouro e da população — outra vez a mesma chave.
O roteiro
- Confirme a cobertura antes de buscar. Se o município não estiver na base, o resultado vazio não significa nada. Isso precisa entrar na sua nota como lacuna declarada.
- Busque o termo em variações. Nome de empresa com e sem "Ltda", com e sem acento, e o CNPJ, que é o identificador estável. Busca por texto é frágil, e ignorar isso produz conclusão errada por omissão.
- Guarde a edição, não só o resultado. Baixe o PDF ou registre o endereço e a data de publicação. Diário é substituído por errata; o que você viu hoje pode não ser o que estará lá amanhã.
- Monte o CSV com uma linha por menção — data, município, termo encontrado, endereço da edição. Com data e município, ele já roda direto no mapa, que anima a sequência no tempo.
- Cite. Em citar a fonte: o órgão é a prefeitura que publicou, não a plataforma que indexou.
- Confirme em segunda fonte antes de afirmar. O extrato no diário aponta o processo; o contrato está no portal do ente e no PNCP. Uma fonte é indício, duas que batem é outra coisa.
Buscas prontas, sem programar
Para quem não vai usar a API: cada link abre a busca no próprio site do Querido Diário, em todos os municípios cobertos. Lá, filtre pela sua cidade e pelo período. A ressalva acima vale para cada resultado.
- "inexigibilidade" — contratações sem licitação por inviabilidade de competição.
- "dispensa emergencial" — contratações diretas por emergência.
- "termo aditivo" — alterações de contratos em valor e prazo.
- "obra paralisada" — avisos e atos sobre obras paradas.
- "chamamento público" — seleção de organizações para parcerias.
- "transferência especial" — atos sobre emendas recebidas sem convênio.
Perguntas que este dado responde bem
- Em que data este ato foi publicado, e em qual edição? (A pergunta central de qualquer recurso com prazo.)
- Houve publicação de dispensa de licitação neste período? (Termo mais intervalo de datas.)
- Este município publica diário com regularidade? (Contagem de edições por mês — desenha bem numa série temporal.)