# Buscar empresas B2B

Prospecção B2B de empresas usando dados públicos, registros oficiais e LinkedIn.

Modelo de cobrança:
- Primeira requisição (sem chave de cache): 1 crédito B2B
- Paginação (com chave de cache): 0 créditos
- Expiração do cache: 7 dias

REGRA IMPORTANTE: Ao preencher localizacoes, deixe estados vazio, e vice-versa.

Endpoint: POST /b2b/companies
Version: 1.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `pagina` (integer)
    Example: 1

  - `por_pagina` (integer)
    Example: 20

  - `chave_cache` (string)
    Chave de cache (economiza créditos)
    Example: "abc123xyz"

  - `filtros_empresa` (object)

  - `filtros_empresa.nome_empresa` (array)
    Nomes específicos de empresas
    Example: ["Google Brasil Internet Ltda"]

  - `filtros_empresa.localizacoes` (array)
    Cidades (formato "Cidade, UF")
    Example: ["São Paulo, SP","Rio de Janeiro, RJ"]

  - `filtros_empresa.estados` (array)
    Estados (sigla UF)
    Example: ["SP","RJ"]

  - `filtros_empresa.setores` (array)
    Setores empresariais
    Example: ["Tecnologia","Educação"]

  - `filtros_empresa.atividades_cnae` (array)
    Códigos CNAE
    Example: ["6201500"]

  - `filtros_empresa.especialidades` (array)
    Especialidades ou nichos de mercado
    Example: ["Software"]

  - `filtros_empresa.tamanhos_empresa` (array)
    Faixas de número de funcionários
    Example: ["11-50","51-200"]

  - `filtros_empresa.naturezas_juridicas` (array)
    IDs de natureza jurídica
    Example: [1,2,3]

  - `filtros_empresa.tipos_trabalho` (array)
    Tipos de organização
    Example: ["Empresa Privada"]

  - `filtros_empresa.data_fundacao` (object)
    Período de fundação da empresa

  - `filtros_empresa.data_fundacao.data_inicio` (string)
    Example: "2010-01-01"

  - `filtros_empresa.data_fundacao.data_fim` (string)
    Example: "2023-12-31"

  - `filtros_empresa.faixa_receita` (object)
    Faixa de receita anual em reais

  - `filtros_empresa.faixa_receita.receita_minima` (number)
    Example: 100000

  - `filtros_empresa.faixa_receita.receita_maxima` (number)
    Example: 5000000

  - `filtros_empresa.incluir_mei` (boolean)
    Incluir microempreendedores individuais
    Example: true

  - `filtros_empresa.tem_cnpj` (boolean)
    Apenas empresas com CNPJ
    Example: true

  - `filtros_empresa.tem_email` (boolean)
    Apenas empresas com email disponível
    Example: true

  - `filtros_empresa.tem_telefone` (boolean)
    Apenas empresas com telefone disponível
    Example: true

  - `filtros_empresa.tem_linkedin` (boolean)
    Apenas empresas com perfil LinkedIn
    Example: true

## Response 200 fields (application/json):

  - `chave_cache` (string)
    Example: "abc123xyz"

  - `total` (integer)
    Example: 250

  - `resultados` (array)

  - `resultados.empresa_id` (integer)
    Example: 98765

  - `resultados.cnpj` (string)
    Example: "12345678000199"

  - `resultados.razao_social` (string)
    Example: "Tech Company LTDA"

  - `resultados.nome_fantasia` (string)
    Example: "Tech Company"

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)
    Example: "no credits"

  - `error.description` (string)
    Example: "Você não possui saldo suficiente, disponível 0"

## Response 403 fields (application/json):

  - `error` (string)
    Example: "Invalid token"

## Response 429 fields (application/json):

  - `error` (string)
    Example: "Too Many Requests"