API da BuscaLead

Acesse nossa base de +69 milhões de empresas brasileiras via API REST. Consulte CNPJs, busque por filtros avançados e enriqueça seus dados — direto no seu sistema. O acesso via API Key requer um plano ativo.

+69 mi

Empresas cadastradas

+27 mi

Empresas ativas

REST

JSON + HTTPS

Base URL

https://api.buscalead.com/v1

Autenticação

Todas as requisições autenticadas devem incluir o header Authorization com sua API Key.

Você pode gerar sua API Key na página de configurações da plataforma.

Assinatura obrigatoria: O uso da API via API Key requer uma assinatura ativa. Requisicoes com API Key sem assinatura retornam 402 Payment Required. Assine aqui.

Header de autenticação


                Authorization: Bearer sua_api_key_aqui

Exemplo com cURL


                curl 'https://api.buscalead.com/v1/empresas/search?query=techsoft' \
                -H 'Authorization: Bearer sua_api_key_aqui'

Rate Limiting

A API possui limites de requisições por minuto para garantir estabilidade. Os limites variam conforme o tipo de autenticação.

Tipo	Limite	Janela
Sem autenticação (busca de empresas)	`15`	1 minuto
Sem autenticação (demais rotas)	`20`	1 minuto
Com API Key	`60`	1 minuto
Rotas de referência (CNAEs, Estados...)	`200`	1 minuto

Ao exceder o limite, a API retorna 429 Too Many Requests com o tempo restante no header Retry-After.

Erros

Todas as respostas de erro seguem o mesmo formato JSON.

Formato de erro


                {
                "title": "Validation Error",
                "message": "O campo 'query' é obrigatório",
                "code": 400
                }

Código	Descrição
`200`	Sucesso
`201`	Recurso criado
`400`	Erro de validação nos parâmetros
`401`	Não autenticado — API Key ausente ou inválida
`402`	Assinatura ativa necessária para uso via API Key
`403`	Acesso negado — requisição identificada como bot ou scraper
`404`	Recurso não encontrado
`429`	Rate limit excedido
`500`	Erro interno do servidor

Paginação

Todos os endpoints de listagem retornam resultados paginados com o mesmo formato.

Formato de paginação


                {
                "page": 0,
                "pageSize": 10,
                "total": 12847,
                "totalPages": 1285,
                "results": [...]
                }

GET

Busca rápida

Busca por texto livre com paginação. Ideal para autocomplete e buscas simples.

/empresas/search

Query Parameters

Parâmetro	Tipo	Padrão	Descrição
`query`	string	—	Termo de busca (razão social, nome fantasia, CNPJ)
`page`	number	0	Número da página
`pageSize`	number	10	Resultados por página (máx. 100)

GET /empresas/search


                curl 'https://api.buscalead.com/v1/empresas/search?query=techsoft&page=0&pageSize=10' \
                -H 'Authorization: Bearer sua_api_key_aqui'

Resposta — 200 OK


                {
                "page": 0,
                "pageSize": 10,
                "total": 3,
                "totalPages": 1,
                "results": [
                {
                "cnpj_completo": "12345678000199",
                "nome_fantasia": "TechSoft",
                "slug": "techsoft",
                "situacao_cadastral": "01",
                "telefone_1": "1133334444",
                "ddd_1": "11",
                "correio_eletronico": "contato@techsoft.com",
                "uf": "SP",
                "cnae_fiscal_principal": "6209100",
                "data_inicio_atividade": "2019-03-15",
                "empresa": {
                "razao_social": "TechSoft Soluções em TI Ltda"
                },
                "municipio_ref": {
                "descricao": "São Paulo"
                }
                }
                ]
                }

POST

Busca avançada

Busca com filtros avançados (CNAE, estado, município, porte, capital social e mais).

/empresas/search

Body Parameters

Campo	Tipo	Descrição
`filters.cnae_fiscal_principal`	string[]	Códigos CNAE principais
`filters.estado`	string[]	Siglas dos estados (ex: ["SP", "RJ"])
`filters.municipio`	string[]	Códigos de municípios
`filters.situacao_cadastral`	string[]	Situação cadastral (01=ativa, 02=baixada...)
`filters.porte`	string[]	Porte da empresa
`filters.natureza_juridica`	string[]	Códigos de natureza jurídica
`filters.capital_social_de`	number	Capital social mínimo
`filters.capital_social_ate`	number	Capital social máximo
`filters.razao_social`	string	Busca por razão social
`filters.contem_email`	boolean	Apenas empresas com e-mail
`filters.contem_celular`	boolean	Apenas empresas com celular
`filters.somente_mei`	boolean	Apenas MEI
`filters.excluir_mei`	boolean	Excluir MEI dos resultados
`filters.somente_matriz`	boolean	Apenas matrizes
`filters.ignorar_ja_importados`	boolean	Exclui dos resultados os leads já importados pela organização. Requer `organization_id`
`organization_id`	string	ID da organização. Obrigatório quando `filters.ignorar_ja_importados` é `true`
`page`	number	Número da página (padrão: 0)
`limit`	number	Resultados por página (padrão: 10)

POST /empresas/search


                curl -X POST 'https://api.buscalead.com/v1/empresas/search' \
                -H 'Authorization: Bearer sua_api_key_aqui' \
                -H 'Content-Type: application/json' \
                -d '{
                "filters": {
                "cnae_fiscal_principal": ["6209100"],
                "estado": ["SP"],
                "situacao_cadastral": ["01"],
                "contem_email": true,
                "ignorar_ja_importados": true
                },
                "organization_id": "uuid-da-organizacao",
                "page": 0,
                "limit": 10
                }'

GET

Detalhes da empresa

Retorna informações completas de uma empresa: dados cadastrais, sócios, CNAEs secundários, endereço e mais.

/empresas/search/:slug

Path Parameters

Parâmetro	Tipo	Descrição
`slug`	string	Slug da empresa (retornado na busca)

GET /empresas/search/:slug


                curl 'https://api.buscalead.com/v1/empresas/search/techsoft' \
                -H 'Authorization: Bearer sua_api_key_aqui'

A resposta inclui:

Dados cadastrais completos (CNPJ, razão social, nome fantasia)
Capital social, porte, natureza jurídica
Telefones, e-mail, endereço completo
Lista de sócios com qualificação
CNAE principal e secundários com descrição
Dados do Simples Nacional / MEI

GET

Detalhes da empresa por CNPJ

Retorna informações completas de uma empresa a partir do CNPJ. Aceita CNPJ com ou sem formatação (pontos, barras e hífens são removidos automaticamente).

/empresas/cnpj/:cnpj

Path Parameters

Parâmetro	Tipo	Descrição
`cnpj`	string	CNPJ da empresa (ex: `06990590000123` ou `06.990.590/0001-23`)

GET /empresas/cnpj/:cnpj


                curl 'https://api.buscalead.com/v1/empresas/cnpj/06990590000123' \
                -H 'Authorization: Bearer sua_api_key_aqui'

Resposta — 200 OK


                {
                "cnpj_completo": "06990590000123",
                "nome_fantasia": "GOOGLE",
                "slug": "google-brasil-internet-ltda-06990590000123",
                "situacao_cadastral": "02",
                "telefone_1": "30444000",
                "ddd_1": "11",
                "correio_eletronico": "contato@google.com.br",
                "uf": "SP",
                "cnae_fiscal_principal": "6311900",
                "empresa": {
                "razao_social": "GOOGLE BRASIL INTERNET LTDA",
                "capital_social": 1000000.00,
                "porte": "DEMAIS",
                "natureza_juridica_ref": {
                "descricao": "Sociedade Empresária Limitada",
                "codigo": "2062"
                },
                "dados_simples": null,
                "socios": [
                {
                "nome_socio": "NOME DO SOCIO",
                "cnpj_cpf_do_socio": "***000000**",
                "qualificacao_do_socio": "49",
                "qualificacao_ref": {
                "codigo": "49",
                "descricao": "Sócio-Administrador"
                },
                "data_entrada_sociedade": "2020-01-15",
                "faixa_etaria": "4"
                }
                ]
                },
                "cnae_principal_ref": {
                "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
                },
                "municipio_ref": {
                "descricao": "SAO PAULO"
                },
                "cnae_fiscal_secundaria_descricoes": [
                {
                "codigo": "6319400",
                "descricao": "Portais, provedores de conteúdo e outros serviços de informação na internet"
                }
                ]
                }

A resposta inclui:

Dados cadastrais completos (CNPJ, razão social, nome fantasia)
Capital social, porte, natureza jurídica
Telefones, e-mail, endereço completo
Lista de sócios com qualificação
CNAE principal e secundários com descrição
Dados do Simples Nacional / MEI

O CNPJ é sanitizado automaticamente — caracteres não numéricos são removidos. Os resultados são cacheados por 30 dias para melhor performance.

GET

CNAEs

Busca de códigos CNAE com correspondência fuzzy e sem acentuação.

/cnaes

Query Parameters

Parâmetro	Tipo	Padrão	Descrição
`search`	string	—	Busca por código ou descrição
`offset`	number	0	Pular registros
`limit`	number	20	Quantidade de resultados

GET /cnaes


                curl 'https://api.buscalead.com/v1/cnaes?search=tecnologia' \
                -H 'Authorization: Bearer sua_api_key_aqui'
                // Resposta
                {
                "results": [
                { "codigo": "6209100", "descricao": "6209100 - Consultoria em tecnologia da informação" }
                ],
                "total": 245,
                "offset": 0,
                "limit": 20,
                "totalPages": 13
                }

GET

Estados e Municípios

Consulte os 27 estados brasileiros e seus municípios.

GET /estados

Lista todos os estados

GET /estados/:uf

Lista municípios de um ou mais estados (separar por vírgula: SP,RJ)

GET /estados/SP


                curl 'https://api.buscalead.com/v1/estados/SP?search=campinas' \
                -H 'Authorization: Bearer sua_api_key_aqui'
                // Resposta
                {
                "results": [
                { "id": "3509502", "nome": "Campinas", "codigo_uf": 35 }
                ],
                "total": 1
                }

GET

Natureza Jurídica

Consulte os tipos de natureza jurídica para usar como filtro.

/natureza_juridica

Mesmos parâmetros de paginação: search, offset, limit.

API da BuscaLead

Autenticação

Rate Limiting

Erros

Paginação

Endpoints — Empresas

Busca rápida

Query Parameters

Busca avançada

Body Parameters

Detalhes da empresa

Path Parameters

Detalhes da empresa por CNPJ

Path Parameters

Endpoints — Referência

CNAEs

Query Parameters

Estados e Municípios

Natureza Jurídica