# Buscar pessoas B2B

Prospecção B2B de pessoas físicas com filtros avançados de perfil profissional e empresa.

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

O campo id_pessoa retornado pode ser usado no endpoint de Enriquecimento de Pessoas.

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

## Request fields (application/json):

  - `pagina` (integer)
    Número da página
    Example: 1

  - `por_pagina` (integer)
    Itens por página (máximo 50)
    Example: 20

  - `chave_cache` (string)
    Chave de cache (economiza créditos em requisições subsequentes)
    Example: "abc123xyz"

  - `filtros_pessoa` (object)

  - `filtros_pessoa.departamentos` (array)
    Departamentos profissionais
    Example: ["Tecnologia","Marketing"]

  - `filtros_pessoa.niveis_senioridade` (array)
    Níveis de senioridade
    Example: ["Sênior","Pleno"]

  - `filtros_pessoa.cargos` (array)
    Cargos profissionais
    Example: ["Desenvolvedor","Gerente"]

  - `filtros_pessoa.habilidades` (array)
    Habilidades técnicas ou profissionais
    Example: ["Python","JavaScript"]

  - `filtros_pessoa.periodos_trabalho` (array)
    Períodos de trabalho em empresas

  - `filtros_pessoa.localizacoes` (array)
    Cidades (formato "Cidade, UF")
    Example: ["São Paulo, SP"]

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

  - `filtros_pessoa.has_email` (boolean)
    Possui email disponível
    Example: true

  - `filtros_pessoa.has_phone` (boolean)
    Possui telefone disponível
    Example: true

  - `filtros_pessoa.has_cnpj` (boolean)
    Possui vínculo com CNPJ
    Example: true

  - `filtros_pessoa.has_linkedin` (boolean)
    Possui perfil LinkedIn
    Example: true

  - `filtros_empresa` (object)

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

  - `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

  - `url_webhook` (string)
    URL para callback assíncrono
    Example: "https://seusite.com/webhook"

## Response 200 fields (application/json):

  - `chave_cache` (string)
    Chave para usar em paginação (evita custos adicionais)
    Example: "abc123xyz"

  - `total` (integer)
    Total de resultados encontrados
    Example: 150

  - `resultados` (array)

  - `resultados.id_pessoa` (integer)
    Example: 12345

  - `resultados.nome` (string)
    Example: "João Silva"

  - `resultados.cargo` (string)
    Example: "Desenvolvedor Sênior"

  - `resultados.empresa` (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"