Radar DOU

A API do Radar DOU oferece endpoints RESTful para buscar publicacoes no Diario Oficial da Uniao, consultar detalhes de documentos, listar secoes e acessar edicoes especificas.

URL Base da API

https://radardou.com.br/api/v1

Todas as requisicoes devem incluir o header de autenticacao X-API-Key com sua chave de API valida.

GET /buscar

Realiza buscas por publicacoes no Diario Oficial da Uniao utilizando diversos filtros.

Parametros de Query

Parametro	Tipo	Obrigatorio	Descricao
`termo`	string	Sim	Termo de busca (palavras-chave)
`data_inicio`	string	Nao	Data inicial (formato: YYYY-MM-DD)
`data_fim`	string	Nao	Data final (formato: YYYY-MM-DD)
`secao`	string	Nao	Filtrar por secao (1, 2, 3, extra)
`orgao`	string	Nao	Filtrar por orgao emissor
`tipo_ato`	string	Nao	Tipo do ato (portaria, decreto, etc.)
`pagina`	integer	Nao	Numero da pagina (default: 1)
`limite`	integer	Nao	Itens por pagina (default: 20, max: 100)

Exemplo de Requisicao

GET /api/v1/buscar?termo=licitacao&data_inicio=2024-01-01&secao=3&limite=10

Headers:
  X-API-Key: rdou_live_sua_chave_aqui
  Content-Type: application/json

Exemplo de Resposta

{
  "sucesso": true,
  "dados": {
    "total": 1523,
    "pagina": 1,
    "limite": 10,
    "total_paginas": 153,
    "resultados": [
      {
        "id": "pub_abc123",
        "titulo": "AVISO DE LICITACAO PREGAO ELETRONICO N 15/2024",
        "resumo": "Contratacao de servicos de...",
        "data_publicacao": "2024-01-15",
        "secao": "3",
        "orgao": "Ministerio da Saude",
        "tipo_ato": "Aviso de Licitacao",
        "url_original": "https://..."
      }
    ]
  }
}

GET /publicacao/{id}

Retorna os detalhes completos de uma publicacao especifica.

Parametros de Path

Parametro	Tipo	Descricao
`id`	string	ID unico da publicacao (ex: pub_abc123)

Exemplo de Requisicao

GET /api/v1/publicacao/pub_abc123

Headers:
  X-API-Key: rdou_live_sua_chave_aqui

Exemplo de Resposta

{
  "sucesso": true,
  "dados": {
    "id": "pub_abc123",
    "titulo": "AVISO DE LICITACAO PREGAO ELETRONICO N 15/2024",
    "conteudo_completo": "O Ministerio da Saude, por meio da...",
    "resumo": "Contratacao de servicos de...",
    "data_publicacao": "2024-01-15",
    "secao": "3",
    "pagina": "45",
    "edicao": "12",
    "orgao": "Ministerio da Saude",
    "tipo_ato": "Aviso de Licitacao",
    "assinatura": "FULANO DE TAL - Pregoeiro",
    "url_original": "https://...",
    "url_pdf": "https://...",
    "palavras_chave": ["licitacao", "pregao", "servicos"],
    "publicacoes_relacionadas": ["pub_def456", "pub_ghi789"]
  }
}

GET /secoes

Lista todas as secoes disponiveis do Diario Oficial da Uniao.

Exemplo de Requisicao

GET /api/v1/secoes

Headers:
  X-API-Key: rdou_live_sua_chave_aqui

Exemplo de Resposta

{
  "sucesso": true,
  "dados": [
    {
      "codigo": "1",
      "nome": "Secao 1",
      "descricao": "Atos normativos - Leis, decretos, resolucoes, instrucoes normativas"
    },
    {
      "codigo": "2",
      "nome": "Secao 2",
      "descricao": "Atos de pessoal - Nomeacoes, exoneracoes, aposentadorias"
    },
    {
      "codigo": "3",
      "nome": "Secao 3",
      "descricao": "Contratos, editais, avisos e outros"
    },
    {
      "codigo": "extra",
      "nome": "Edicao Extra",
      "descricao": "Publicacoes de urgencia fora do horario normal"
    }
  ]
}

GET /edicoes

Lista as edicoes do DOU com opcao de filtro por data.

Parametros de Query

Parametro	Tipo	Obrigatorio	Descricao
`data`	string	Nao	Data especifica (YYYY-MM-DD)
`mes`	string	Nao	Mes especifico (YYYY-MM)
`ano`	integer	Nao	Ano especifico (ex: 2024)

Exemplo de Requisicao

GET /api/v1/edicoes?mes=2024-01

Headers:
  X-API-Key: rdou_live_sua_chave_aqui

Exemplo de Resposta

{
  "sucesso": true,
  "dados": [
    {
      "numero": "12",
      "data": "2024-01-15",
      "tipo": "normal",
      "secoes": ["1", "2", "3"],
      "total_publicacoes": 456
    },
    {
      "numero": "12-A",
      "data": "2024-01-15",
      "tipo": "extra",
      "secoes": ["1"],
      "total_publicacoes": 15
    }
  ]
}

Codigos de Status HTTP

Codigo	Status	Descricao
200	OK	Requisicao bem-sucedida
400	Bad Request	Parametros invalidos ou ausentes
401	Unauthorized	API Key ausente ou invalida
403	Forbidden	Sem permissao para acessar o recurso
404	Not Found	Recurso nao encontrado
429	Too Many Requests	Limite de requisicoes excedido
500	Internal Error	Erro interno do servidor

Headers de Resposta

Todas as respostas incluem headers uteis para monitoramento:

Header	Descricao
`X-RateLimit-Limit`	Limite total de requisicoes por minuto
`X-RateLimit-Remaining`	Requisicoes restantes na janela atual
`X-RateLimit-Reset`	Timestamp Unix do reset do limite
`X-Request-Id`	ID unico da requisicao para debug

SDKs Disponiveis

Para facilitar a integracao, oferecemos SDKs oficiais em diversas linguagens:

Python: pip install radardou
JavaScript/Node.js: npm install radardou
R: install.packages("radardou")
Julia: using Pkg; Pkg.add("RadarDOU")
MATLAB: Disponivel via Add-On Explorer

Precisa de ajuda? Consulte os artigos sobre exemplos em Python e JavaScript para ver implementacoes completas, ou use nosso assistente virtual para tirar duvidas sobre os endpoints.

Endpoints disponíveis

URL Base da API

GET /buscar

Parametros de Query

Exemplo de Requisicao

Exemplo de Resposta

GET /publicacao/{id}

Parametros de Path

Exemplo de Requisicao

Exemplo de Resposta

GET /secoes

Exemplo de Requisicao

Exemplo de Resposta

GET /edicoes

Parametros de Query

Exemplo de Requisicao

Exemplo de Resposta

Codigos de Status HTTP

Headers de Resposta

SDKs Disponiveis

Ainda tem dúvidas?