Busca Avançada de Empresas

Realize buscas complexas com múltiplos filtros e paginação.

Informações Gerais

Item	Descrição
Autenticação	Header `X-API-Key` obrigatório
Custo	Consulte em platform.kipflow.io/pricing
Paginação	Máximo 50 resultados por página
Rate Limit	5/seg • 100/min • 1000/hora

Formato dos Filtros

Os filtros seguem o formato de query com operadores $or, $and, $not, $gt, $lt e $in:

{
  "$filter": {
    "$and": [
      {
        "$or": [
          { "situacao_cadastral": "ATIVA" }
        ]
      },
      {
        "$or": [
          { "matriz": "TRUE" }
        ]
      }
    ]
  },
  "$page": 0,
  "$size": 20,
  "datasets": ["basic", "complete"]
}

Campos Filtráveis

Exatamente 48 campos podem ser usados como filtros:

Identificação (5 campos)

cnpj, raiz_cnpj, dv_cnpj

razao_social, nome_fantasia

Situação (2 campos)

situacao_cadastral (ATIVA, BAIXADA, etc.)

data_inicio_atividade

Classificação (6 campos)

natureza_juridica, porte, empresa_publico_privada

matriz (boolean), qtde_filiais, segmento

CNAE (8 campos)

cnae_principal_classe, cnae_principal_subclasse

cnae_principal_desc_classe, cnae_principal_desc_subclasse

cnae_principal_desc_divisao, cnae_principal_desc_grupo, cnae_principal_desc_secao

atividades_secundarias (array: classe, desc_classe, divisao, grupo, secao, segmento, subclasse, ramo_de_atividade)

Localização (8 campos)

endereco, bairro, cep, municipio, uf

macrorregiao (SUL, SUDESTE, NORDESTE, NORTE, CENTRO-OESTE)

lat, lon (coordenadas)

perfil_socioeconomico_bairro_desc (BAIXO, MEDIO, ALTO)

Financeiro (8 campos)

capital_social, faturamento, faturamento_grupo

faixa_faturamento_grupo (ex: "40M A 50M")

faixa_funcionarios_grupo (ex: "100 A 249")

forma_de_tributacao, forma_de_tributacao_ajustada

opcao_pelo_simples (boolean), opcao_pelo_mei (boolean)

RAT/PAT (3 campos)

aliquota_percentual_rat, possui_pat, qtde_beneficiarios_pat

INPI (1 campo)

qtde_registros_inpi

Presença Online (4 campos)

sites (array: site, confiabilidade, ecommerce, tecnologias)

facebook, instagram (arrays: url)

linkedin_url

Sócios (1 campo array)

socios (cpf, nome_socio, qualificacao_socio, data_nascimento, faixa_etaria_socio, sexo, data_entrada_sociedade, identificador_socio)

Exemplos de Filtros

// Empresas ativas de São Paulo com faturamento alto
{
  "$filter": {
    "$and": [
      { "situacao_cadastral": "ATIVA" },
      { "uf": "PARANA" },
      { "faixa_faturamento_grupo": "40M A 50M" }
    ]
  }
}

// Matrizes do setor de tecnologia
{
  "$filter": {
    "$and": [
      { "matriz": true },
      { "segmento": "SERVICOS" },
      { "cnae_principal_desc_divisao": "62 - ATIVIDADES DOS SERVICOS DE TECNOLOGIA DA INFORMACAO" }
    ]
  }
}

Paginação

$page: Número da página (default: 0)

$size: Quantidade por página (default: 5, máximo: 50)

Custo

O custo é calculado por empresa retornada baseado nos datasets selecionados.

curl --location --request POST 'https://api.kipflow.io/companies/v1/search' \ --header 'X-API-Key: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "$filter": { "$and": [ { "$or": [ { "situacao_cadastral": "ATIVA" } ] }, { "$or": [ { "matriz": "TRUE" } ] } ] }, "$page": 0, "$size": 5, "datasets": [ "basic", "complete", "address" ] }'

{ "success": true, "data": [ { "cnpj": 35965725000107, "raiz_cnpj": 0, "dv_cnpj": 0, "razao_social": "DRIVA TECNOLOGIA LTDA", "nome_fantasia": "DRIVA TECNOLOGIA LTDA", "situacao_cadastral": "ATIVA", "data_inicio_atividade": "string", "natureza_juridica": "string", "porte": "DEMAIS", "empresa_publico_privada": "string", "matriz": true, "qtde_filiais": 0, "segmento": "string", "cnae_principal_classe": 0, "cnae_principal_desc_classe": "string", "cnae_principal_desc_divisao": "string", "cnae_principal_desc_grupo": "string", "cnae_principal_desc_secao": "string", "cnae_principal_desc_subclasse": "string", "cnae_principal_subclasse": 0, "atividades_secundarias": [ { "classe": 0, "desc_classe": "string", "desc_divisao": "string", "desc_grupo": "string", "desc_secao": "string", "desc_subclasse": "string", "divisao": 0, "grupo": 0, "ramo_de_atividade": "string", "secao": "string", "segmento": "string", "subclasse": 0 } ], "endereco": "RUA LAURA NUNES FERNANDES 211 - PARQUE DA FONTE - 83050610", "bairro": "string", "cep": 0, "municipio": "string", "uf": "string", "macrorregiao": "string", "lat": 0, "lon": 0, "perfil_socioeconomico_bairro_desc": "string", "capital_social": 0, "faturamento": 0, "faturamento_grupo": 0, "faixa_faturamento_grupo": "string", "faixa_funcionarios_grupo": "string", "forma_de_tributacao": "string", "forma_de_tributacao_ajustada": "string", "opcao_pelo_simples": true, "opcao_pelo_mei": true, "aliquota_percentual_rat": 0, "possui_pat": true, "qtde_beneficiarios_pat": 0, "qtde_registros_inpi": 0, "sites": [ { "confiabilidade": 0, "ecommerce": true, "pertence_contador": true, "site": "string", "tecnologias": [ "string" ] } ], "facebook": [ { "url": "string" } ], "instagram": [ { "url": "string" } ], "linkedin_url": "string", "twitter": "string", "emails": [ { "email": "string", "nome": "string", "pertence_contador": true } ], "telefones": [ { "fixo_movel": "string", "pertence_contador": true, "score_original": 0, "telefone_completo": "string", "validado_discador": true, "whatsapp": true } ], "socios": [ { "cnpj_cpf_socio": "string", "contatos_id": "string", "cpf": "string", "data_entrada_sociedade": "string", "data_nascimento": "string", "faixa_etaria_socio": "string", "identificador_socio": "string", "nome_com_cnpj_cpf": "string", "nome_socio": "string", "qualificacao_representante_legal": "string", "qualificacao_socio": "string", "sexo": "string" } ], "divida": { "dividas": [ { "data_inscricao": "2024-07-20", "indicador_ajuizado": "SIM", "nome_devedor": "GERDAU ACOMINAS SA", "numero_inscricao": "373656998", "receita_principal": "RECEITA DA DIVIDA ATIVA - IRPJ", "situacao_inscricao": "PENHORA REGULAR E SUFICIENTE", "tipo_devedor": "PRINCIPAL", "tipo_divida": "PREVIDENCIARIA", "tipo_pessoa": "PESSOA JURIDICA", "tipo_situacao_inscricao": "GARANTIA", "uf_devedor": "MG", "unidade_responsavel": "6a REGIAO", "valor_consolidado": 6156493 } ], "total": 2011165995, "total_fgts": 0, "total_nao_previdenciaria": 2001332363, "total_previdenciaria": 9833632 } } ], "datasets": [ "basic", "complete" ], "pagination": { "page": 0, "size": 5, "total": 42 }, "cost": 0.1, "costFormatted": "R$ 0.10" }

Buscar Empresas com Filtros

Busca Avançada de Empresas

Informações Gerais

Formato dos Filtros

Campos Filtráveis

Identificação (5 campos)

Situação (2 campos)

Classificação (6 campos)

CNAE (8 campos)

Localização (8 campos)

Financeiro (8 campos)

RAT/PAT (3 campos)

INPI (1 campo)

Presença Online (4 campos)

Sócios (1 campo array)

Exemplos de Filtros

Paginação

Custo

Requisição

Respostas

Buscar Empresas com Filtros

Busca Avançada de Empresas#

Informações Gerais#

Formato dos Filtros#

Campos Filtráveis#

Identificação (5 campos)#

Situação (2 campos)#

Classificação (6 campos)#

CNAE (8 campos)#

Localização (8 campos)#

Financeiro (8 campos)#

RAT/PAT (3 campos)#

INPI (1 campo)#

Presença Online (4 campos)#

Sócios (1 campo array)#

Exemplos de Filtros#

Paginação#

Custo#

Requisição

Respostas

Busca Avançada de Empresas

Informações Gerais

Formato dos Filtros

Campos Filtráveis

Identificação (5 campos)

Situação (2 campos)

Classificação (6 campos)

CNAE (8 campos)

Localização (8 campos)

Financeiro (8 campos)

RAT/PAT (3 campos)

INPI (1 campo)

Presença Online (4 campos)

Sócios (1 campo array)

Exemplos de Filtros

Paginação

Custo