Documentação da API

Conecte-se com nossa poderosa API para integrar dados de empresas em suas aplicações

Introdução

Bem-vindo à documentação da API CNPJLeads. Esta API permite que você acesse programaticamente dados de empresas do nosso banco de dados.

Autenticação

Todas as requisições à API exigem autenticação usando um token de API. Você pode gerar um token na sua página de perfil.

Inclua seu token de API no cabeçalho Authorization de suas requisições: 
Authorization: Bearer YOUR_API_TOKEN

Exemplos de Código

curl -X GET "https://cnpjleads.com/api/v1/companies/search?state=SP&page=1" \
-H "Authorization: Bearer YOUR_API_TOKEN"
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://cnpjleads.com/api/v1/companies/search?state=SP&page=1");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_TOKEN"
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
fetch("https://cnpjleads.com/api/v1/companies/search?state=SP&page=1", {
    headers: {
        "Authorization": "Bearer YOUR_API_TOKEN"
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
import requests

url = "https://cnpjleads.com/api/v1/companies/search"
params = {"state": "SP", "page": 1}
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class ApiExample {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://cnpjleads.com/api/v1/companies/search?state=SP&page=1");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");
            conn.setRequestProperty("Authorization", "Bearer YOUR_API_TOKEN");
            
            BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String inputLine;
            StringBuffer response = new StringBuffer();
            while ((inputLine = in.readLine()) != null) {
                response.append(inputLine);
            }
            in.close();
            
            System.out.println(response.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        using (HttpClient client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_TOKEN");
            
            HttpResponseMessage response = await client.GetAsync("https://cnpjleads.com/api/v1/companies/search?state=SP&page=1");
            response.EnsureSuccessStatusCode();
            
            string responseBody = await response.Content.ReadAsStringAsync();
            Console.WriteLine(responseBody);
        }
    }
}

Formato de Resposta

Todas as respostas da API são retornadas no formato JSON. Respostas bem-sucedidas incluem um campo "success" definido como true, enquanto respostas de erro incluem uma mensagem de erro.

Limitação de Taxa

As requisições da API são limitadas a 100 requisições por minuto por usuário. Se você exceder esse limite, receberá uma resposta 429 Too Many Requests.

Tratamento de Erros

A API usa códigos de status HTTP padrão para indicar sucesso ou falha das requisições. Em caso de erro, a resposta incluirá uma mensagem de erro.

Success Response (200 OK)

{
  "success": true,
  "data": { ... }
}

Error Response (400 Bad Request)

{
  "success": false,
  "message": "Invalid input parameters"
}

Idiomas

A API suporta múltiplos idiomas. Você pode especificar seu idioma preferido usando o parâmetro "locale" em suas requisições.

Locale Language
pt-br Português (Brasil)
en English
es Español

Paginação

Os resultados são paginados para melhorar o desempenho. Você pode navegar pelas páginas usando o parâmetro "page" e alterar o número de resultados por página usando o parâmetro "per_page".

Pagination Response Format

{
  "success": true,
  "total": 100,
  "per_page": 20,
  "current_page": 1,
  "last_page": 5,
  "from": 1,
  "to": 20,
  "data": [ ... ]
}

Endpoints

GET /api/v1/companies/search

Buscar empresas usando vários filtros

Parâmetros

Parâmetro Tipo Descrição
business_sector string Filtrar por código de setor de atividade (CNAE)
city string Filtrar por nome de cidade
state string Filtrar por código de estado (UF)
company_size string Filtrar por código de porte da empresa
opening_date_from date Filtrar por data de abertura (de) no formato YYYY-MM-DD
opening_date_to date Filtrar por data de abertura (até) no formato YYYY-MM-DD
trading_name string Filtrar por nome fantasia
neighborhood string Filtrar por bairro
zip_code string Filtrar por CEP
nature_code string Filtrar por código de natureza jurídica
cnpj string Filtrar por número de CNPJ
situacao_cadastral string Filtrar por código de situação cadastral
page integer Número da página para paginação
locale string Idioma preferido para resposta (pt-br, en, es)

Exemplo de Resposta

{
    "success": true,
    "total": 100,
    "per_page": 20,
    "current_page": 1,
    "last_page": 5,
    "from": 1,
    "to": 20,
    "data": [
        {
            "id": "12345678",
            "cnpj": "12345678000199",
            "razao_social": "EMPRESA EXEMPLO LTDA",
            "nome_fantasia": "EMPRESA EXEMPLO",
            "situacao_cadastral": "Ativa",
            "situacao_cadastral_code": "02",
            "porte_empresa": "Empresa de Pequeno Porte",
            "porte_empresa_code": "03",
            "cnae_fiscal": "6201500",
            "cnae_fiscal_descricao": "Desenvolvimento de programas de computador sob encomenda",
            "endereco": {
                "logradouro": "Rua Exemplo",
                "numero": "123",
                "complemento": "Sala 1",
                "bairro": "Centro",
                "municipio": "3550308",
                "municipio_nome": "São Paulo",
                "uf": "SP",
                "cep": "01234567"
            },
            "contato": {
                "ddd": "11",
                "telefone": "12345678",
                "email": "contato@exemplo.com"
            },
            "socios": [
                {
                    "nome": "SOCIO EXEMPLO",
                    "qualificacao": "49",
                    "tipo": "2",
                    "documento": "***123456**"
                }
            ],
            "data_inicio_atividades": "2010-01-01"
        }
    ]
}
GET /api/v1/companies/{cnpj}

Obter informações detalhadas de uma empresa específica por CNPJ

Parâmetros

Parâmetro Tipo Descrição
cnpj string Número de CNPJ no caminho
locale string Idioma preferido para resposta (pt-br, en, es)

Exemplo de Resposta

{
    "success": true,
    "data": {
        "id": "12345678",
        "cnpj": "12345678000199",
        "razao_social": "EMPRESA EXEMPLO LTDA",
        "nome_fantasia": "EMPRESA EXEMPLO",
        "situacao_cadastral": "Ativa",
        "situacao_cadastral_code": "02",
        "natureza_juridica": "SOCIEDADE EMPRESÁRIA LIMITADA",
        "natureza_juridica_code": "2062",
        "porte_empresa": "Empresa de Pequeno Porte",
        "porte_empresa_code": "03",
        "cnae_fiscal": "6201500",
        "cnae_fiscal_descricao": "Desenvolvimento de programas de computador sob encomenda",
        "endereco": {
            "logradouro": "Rua Exemplo",
            "numero": "123",
            "complemento": "Sala 1",
            "bairro": "Centro",
            "municipio": "3550308",
            "municipio_nome": "São Paulo",
            "uf": "SP",
            "cep": "01234567",
            "endereco_completo": "Rua Exemplo, 123 - Sala 1, Centro, São Paulo/SP - 01234-567"
        },
        "contato": {
            "ddd": "11",
            "telefone": "12345678",
            "telefone_formatado": "(11) 12345678",
            "email": "contato@exemplo.com"
        },
        "socios": [
            {
                "nome": "SOCIO EXEMPLO",
                "qualificacao": "49",
                "tipo": "2",
                "documento": "***123456**"
            }
        ],
        "data_inicio_atividades": "2010-01-01",
        "capital_social": "100000.00"
    }
}
GET /api/v1/reference-data

Obter dados de referência incluindo setores, estados, portes de empresas e naturezas jurídicas

Parâmetros

Parâmetro Tipo Descrição
locale string Idioma preferido para resposta (pt-br, en, es)

Exemplo de Resposta

{
    "success": true,
    "data": {
        "business_sectors": [
            {
                "code": "6201500",
                "description": "Desenvolvimento de programas de computador sob encomenda"
            }
        ],
        "states": [
            "AC",
            "AL",
            "AM",
            "AP",
            "BA"
        ],
        "company_sizes": [
            "01",
            "03",
            "05",
            "08"
        ],
        "legal_natures": [
            {
                "code": "2062",
                "description": "SOCIEDADE EMPRESÁRIA LIMITADA"
            }
        ],
        "registration_statuses": {
            "01": "Nula",
            "02": "Ativa",
            "03": "Suspensa",
            "04": "Inapta",
            "08": "Baixada"
        },
        "locale": "pt-br",
        "available_locales": {
            "pt-br": "Português (Brasil)",
            "en": "English",
            "es": "Español"
        }
    }
}

Precisa de Ajuda?

Se você tiver dúvidas ou precisar de assistência com a API, entre em contato com nossa equipe de suporte:

suporte@cnpjleads.com

Recursos para Desenvolvedores

Status da API

Ver status atual da API

Operational

Registro de Alterações

Ver histórico de versões da API

Latest: v1.0.0 (2025-04-24)

FAQ

Perguntas Frequentes

View FAQ

Pronto para integrar com nossa API? Obtenha sua chave de API e comece a construir hoje

Começar agora
Entre em contato