Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
search
/
company
/
advanced
Busca avançada
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/search/company/advanced \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "taxid": "<string>",
  "name": "<string>",
  "fantasy": "<string>",
  "address": "<string>",
  "uf": "<string>",
  "zipcode": "<string>",
  "similar_name": true,
  "page": 123
}
'
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "items": [
      {
        "taxid": "00.000.000/0000-00",
        "name": "EMPRESA EXEMPLO LTDA",
        "fantasy": "EXEMPLO",
        "location": "São Paulo/SP",
        "status": "ATIVA",
        "activity_start_date": "2020-01-15",
        "address": "AVENIDA EXEMPLO, 100 - CENTRO - São Paulo - SP - 00000-000",
        "uf": "SP",
        "zipcode": "00000000",
        "score": 18.4
      }
    ],
    "has_more": false,
    "page": 1,
    "price": 0.09,
    "charged": 0.09,
    "debit_only_if_found": false,
    "time": 0.42,
    "test": false
  }
}
Executa uma busca avançada de pessoa jurídica em formato paginado. Use esta rota quando você não possui o CNPJ exato ou precisa localizar empresas por dados parciais, como razão social, nome fantasia, logradouro, UF ou CEP. 
{
  "code": 200,
  "message": "Consulta realizada com sucesso.",
  "result": {
    "items": [
      {
        "taxid": "00.000.000/0000-00",
        "name": "EMPRESA EXEMPLO LTDA",
        "fantasy": "EXEMPLO",
        "location": "São Paulo/SP",
        "status": "ATIVA",
        "activity_start_date": "2020-01-15",
        "address": "AVENIDA EXEMPLO, 100 - CENTRO - São Paulo - SP - 00000-000",
        "uf": "SP",
        "zipcode": "00000000",
        "score": 18.4
      }
    ],
    "has_more": false,
    "page": 1,
    "price": 0.09,
    "charged": 0.09,
    "debit_only_if_found": false,
    "time": 0.42,
    "test": false
  }
}

​
Corpo da requisição

​
taxid
string
CNPJ da empresa. Pontuação é aceita e removida automaticamente.
​
name
string
Razão social ou parte da razão social.
​
fantasy
string
Nome fantasia ou parte do nome fantasia.
​
address
string
Logradouro ou parte do endereço.
​
uf
string
Sigla da unidade federativa com 2 letras.
​
zipcode
string
CEP com 8 dígitos. Pontuação é aceita e removida automaticamente.
​
similar_name
boolean
default:"false"
Quando true, permite busca aproximada por razão social ou nome fantasia.
​
page
integer
default:"1"
Página dos resultados. Use a próxima página enquanto has_more for true.
​
x-ambient
string
Use sandbox para executar uma chamada de teste sem consumo de saldo.
Para detalhes sobre chamadas de teste, consulte Ambiente de teste.

​
Regras dos filtros

É necessário informar pelo menos um dos campos aceitos: taxid, name, fantasy, address ou zipcode. Quando taxid for informado, ele deve conter um CNPJ válido após normalização. Quando uf for informado, ele deve conter uma sigla válida com 2 letras.

​
Exemplo de corpo

{
  "name": "EMPRESA EXEMPLO LTDA",
  "uf": "SP",
  "similar_name": true,
  "page": 1
}

​
Resposta

​
code
integer
required
Código da resposta da API.
​
message
string
required
Mensagem descritiva da resposta.
​
result
object
required
Objeto principal com os registros encontrados, dados de paginação, cobrança e tempo de execução.

​
Estrutura de result

CampoTipoDescrição
itemsarray<object>Registros encontrados para os filtros enviados.
has_morebooleanIndica se existe próxima página disponível.
pageintegerPágina retornada.
pricenumberPreço da busca para a conta autenticada.
chargednumberValor debitado nesta chamada. Em sandbox, retorna 0.
debit_only_if_foundbooleanIndica se a cobrança ocorre apenas quando houver resultado útil.
timenumberTempo de execução em segundos.
testbooleanIndica se a chamada foi executada em ambiente de teste.

​
Estrutura de result.items[]

CampoTipoDescrição
taxidstringCNPJ encontrado.
namestringRazão social.
fantasystringNome fantasia, quando disponível.
locationstringLocalização resumida, quando disponível.
statusstringSituação cadastral.
activity_start_datestringData de abertura ou início de atividade no formato yyyy-mm-dd, quando disponível.
addressstringEndereço resumido, quando disponível.
ufstringUF.
zipcodestringCEP, quando disponível.
scorenumberIndicador de similaridade ou relevância do resultado, quando disponível.
Campos de items[] podem não ser retornados em todas as consultas. A disponibilidade depende dos filtros enviados e dos dados existentes para o registro encontrado.

​
Paginação

Quando has_more retornar true, envie a mesma requisição incrementando page. 
{
  "name": "EMPRESA EXEMPLO LTDA",
  "uf": "SP",
  "similar_name": true,
  "page": 2
}

​
Respostas esperadas

StatusQuando ocorre
200Busca executada com sucesso.
400Requisição inválida, filtro ausente ou campo em formato incompatível.
401A chave da API está ausente, inválida ou não pôde ser autenticada.
403A credencial não possui escopo de consulta, o plano não permite acesso ou há bloqueio financeiro.

​
Fluxo recomendado

  1. Envie os filtros mais específicos disponíveis.
  2. Use similar_name: true quando precisar aceitar variações de razão social ou nome fantasia.
  3. Leia items e verifique has_more.
  4. Se has_more for true, consulte a próxima página.
  5. Use x-ambient: sandbox para validar integração sem consumir saldo.