A API do vira-lata mais mendigo de dados públicos.

APIs públicas gratuitas para consulta de CNPJ e CEP. O OpenCaramelo é um projeto open-source que facilita o acesso a dados públicos, oferencendo endpoints simples com retorno em JSON para utilização em aplicações, estudos, pesquisar etc..

Começar a Usar Deixe uma Estrela Ver no GitHub

Como Usar

Comece a usar em segundos. Basta fazer uma requisição HTTP GET para o endpoint desejado.

Requisição CNPJ

Basta informar o CNPJ (somente números) no final da URL. Todos os dados são obtidos de fontes de domínio público.

GET /cnpj/{cnpj}

Exemplo prático:

https://kitana.opencnpj.com/cnpj/12345678000199

Limite de 100 requisições por minuto.

Ver no GitHub

Exemplo de Resposta Real

{
  "success": true,
  "message": null,
  "data": {
    "cnpj": "99988877000199",
    "situacaoCadastral": "Ativa",
    "dataSituacaoCadastral": "15/03/2023",
    "motivoSituacaoCadastral": null,
    "razaoSocial": "OUTWORLD COMBATE E 
	TREINAMENTOS LTDA",
    "nomeFantasia": "Mortal Kombat Arena",
    "dataInicioAtividades": "09/01/1992",
    "matriz": "Sim",
    "naturezaJuridica": "Sociedade Empresária
	Limitada (2062)",
    "capitalSocial": 9500000,
    "email": "[email protected]",
    "telefone": "(11) 99999-1992",
    "logradouro": "AVENIDA SHANG TSUNG",
    "numero": "666",
    "complemento": "CASTELO DAS ALMAS",
    "bairro": "VILA NOVA",
    "municipio": "GOIÂNIA",
    "uf": "GO",
    "cep": "13131-666",
    "dataSituacaoEspecial": null,
    "situacaoEspecial": null,
    "opcaoSimples": "N",
    "opcaoMei": "N",
    "cnaes": [
      {
        "cnae": "9319201",
        "descricao": "Organização de torneios 
		interdimensionais de artes marciais"
      },
      {
        "cnae": "9319202",
        "descricao": "Treinamento e capacitação 
		em combate corpo a corpo"
      }
    ],
    "socios": [
      {
        "nomeSocio": "SHANG TSUNG",
        "descricao": "Sócio-Administrador",
        "identificadorSocio": 2,
        "cnpjCpfSocio": "***666999**",
        "dataEntradaSociedade": "09/01/1992",
        "nomeRepresentante": null,
        "faixaEtaria": "Mais de 100 anos"
      },
      {
        "nomeSocio": "RAIDEN",
        "descricao": "Sócio",
        "identificadorSocio": 2,
        "cnpjCpfSocio": "***777111**",
        "dataEntradaSociedade": "12/03/1995",
        "nomeRepresentante": "LORD FULGORE",
        "faixaEtaria": "41-50 anos"
      },
      {
        "nomeSocio": "LIU KANG",
        "descricao": "Treinador-Chefe",
        "identificadorSocio": 3,
        "cnpjCpfSocio": "***222333**",
        "dataEntradaSociedade": "01/06/2019",
        "nomeRepresentante": null,
        "faixaEtaria": "31-40 anos" }
    ]
  }
}

Requisição CEP

Basta informar o CEP (somente números) no final da URL. Todos os dados são obtidos de fontes de domínio público.

GET /cep/{cep}

Exemplo prático:

https://mileena.opencaramelo.com/cep/74635055

Limite de 100 requisições por minuto.

Ver no GitHub

Exemplo de Resposta

{
  "success": true,
  "data": {
    "cep": "74635055",
    "cepFormatado": "74635-055",
    "uf": "GO",
    "nomeLocalidade": "Goiânia",
    "nomeBairro": "Setor Leste Vila Nova",
    "tipoLogradouro": "Rua",
    "nomeLogradouro": "208",
    "complementoLogradouro": null,
    "unidade": "",
    "codigoIbge": "5208707",
    }
}

Exemplo em projetos reais

Projetos realizados com a API OpenCaramelo.

Terminal de consulta de CNPJ e CEP

Terminal com um design retrô feito para consultas de CNPJ e CEP, desenvolvido em Angular.

Ver template no GitHub Ver ao Vivo

Feito pela Comunidade, para a Comunidade

O OpenCaramelo é um projeto vivo que depende da sua ajuda. A forma mais simples de nos apoiar é deixando uma estrela em nosso repositório no GitHub!

Encontrou um bug ou tem uma sugestão? Abra uma Issue.

Reportar um Erro Deixe uma Estrela

Gostou do Projeto?

Manter um serviço gratuito, rápido e confiável exige tempo e recursos. Se o OpenCaramelo foi útil para você, considere fazer uma pequena doação.

Pague um Café para o Desenvolvedor