# Prospecção B2B

Operações de prospecção e enriquecimento B2B para pessoas e empresas, incluindo filtros avançados, busca com autocomplete e enriquecimento em lote.


## Obter estrutura de filtros B2B

 - [GET /b2b/filter-structure](https://docs.datastone.com.br/api/prospeccao-b2b/get_filter_structure.md): Retorna documentação completa sobre filtros disponíveis para buscas de Pessoas e Empresas.
Inclui nomes de campos, tipos de dados, descrições e indicadores de obrigatoriedade.

## Obter opções de filtros B2B

 - [GET /b2b/filter-options](https://docs.datastone.com.br/api/prospeccao-b2b/get_filter_options.md): Retorna todas as opções pré-definidas para filtros categóricos da API B2B.

REGRA IMPORTANTE: Para filtros com texto e valor, SEMPRE enviar o valor.
- ✅ Válido: {"estado": "SP"}
- ❌ Inválido: {"estado": "São Paulo"}

## Busca com autocomplete

 - [GET /b2b/search](https://docs.datastone.com.br/api/prospeccao-b2b/get_autocomplete_search.md): Busca em tempo real por diferentes tipos de dados com autocomplete.

Parâmetros de busca disponíveis:
- nome_empresa - Nomes de empresas (LinkedIn, razão social, nome fantasia) - Limite: 50
- localizacao - Cidades (passar UF do estado) - Sem limite
- setor - Setor empresarial - Limite: 50
- cargo - Cargos/funções - Limite: 50
- atividade_cnae - Atividades CNAE - Limite: 50
- natureza_juridica - Natureza jurídica - Limite: 50
- especialidade - Especialidades - Limite: 50

## Buscar pessoas B2B

 - [POST /b2b/persons](https://docs.datastone.com.br/api/prospeccao-b2b/post_b2b_persons.md): 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.

## Enriquecer pessoa (individual)

 - [POST /b2b/persons/enrich](https://docs.datastone.com.br/api/prospeccao-b2b/post_b2b_person_enrich.md): Enriquece perfil de pessoa física individualmente com processamento assíncrono.

Custo: 1 crédito por registro enriquecido com sucesso

Dados retornados:
- Básicos: nome completo, CPF (quando disponível), idade, gênero, localização
- Contatos: telefones, emails, perfis públicos
- Vínculos empresariais: participações, cargos corporativos, CNPJs
- Histórico profissional: cargos, empresas, períodos
- Educação: cursos, instituições, níveis de escolaridade

A notificação de conclusão é enviada via webhook (se configurado).

## Enriquecer pessoas em lote

 - [POST /b2b/persons/enrich/bulk](https://docs.datastone.com.br/api/prospeccao-b2b/post_b2b_persons_enrich_bulk.md): Enriquecimento em massa de pessoas físicas com processamento assíncrono e entrega via webhook.

Custo: 1 crédito por registro enriquecido com sucesso

Dados retornados: Mesmos do enriquecimento individual

## Buscar empresas B2B

 - [POST /b2b/companies](https://docs.datastone.com.br/api/prospeccao-b2b/post_b2b_companies.md): 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.

## Enriquecer empresa (individual)

 - [POST /b2b/companies/enrich](https://docs.datastone.com.br/api/prospeccao-b2b/post_b2b_company_enrich.md): Enriquece perfil de empresa individualmente com processamento assíncrono.

Custo: 1 crédito por registro enriquecido

Dados retornados:
- Cadastro: razão social, nome fantasia, data de fundação, CNAEs
- Localização: endereço completo, cidade, estado, CEP, geolocalização
- Contatos: telefones, emails, website oficial
- Informações: setor, descrição, número de funcionários, links públicos
- Estrutura corporativa: sócios, administradores, percentuais de participação
- Histórico: ex-sócios e ex-funcionários
- Filiais e equipe atual

## Enriquecer empresas em lote

 - [POST /b2b/companies/enrich/bulk](https://docs.datastone.com.br/api/prospeccao-b2b/post_b2b_companies_enrich_bulk.md): Enriquecimento em massa de empresas com processamento assíncrono.

Custo: 1 crédito por registro enriquecido

Dados retornados: Mesmos do enriquecimento individual