# Prospecção

Operações de prospecção com filtros geográficos e profissionais, incluindo contagem e geração de jobs de prospecção.


## Prospecção de pessoas (contagem e job)

 - [POST /persons/prospect](https://docs.datastone.com.br/api/prospeccao/post_persons_prospect.md): Duas funcionalidades em um endpoint:

1. Modo Contagem (export: false)
- Retorna quantidade total de pessoas que correspondem aos filtros
- Não consome créditos

2. Modo Prospecção (export: true)
- Cria job de prospecção com filtros especificados
- Retorna job ID

## Prospecção de empresas (contagem e job)

 - [POST /company/prospect](https://docs.datastone.com.br/api/prospeccao/post_company_prospect.md): Duas funcionalidades em um endpoint:

1. Modo Contagem (export: false)
- Retorna quantidade total de registros (empresas e sócios) que correspondem aos filtros
- Não consome créditos

2. Modo Prospecção (export: true)
- Inicia processo de coleta de informações detalhadas das empresas
- Inclui dados de contato dos sócios
- Retorna job ID

## Obter resultado da prospecção

 - [GET /prospection/{job_id}/result](https://docs.datastone.com.br/api/prospeccao/get_prospection_result.md): Recupera o resultado de um job de prospecção.

Se webhook foi configurado, o status do processo será enviado automaticamente.

## Salvar filtro de prospecção

 - [POST /prospection/filters](https://docs.datastone.com.br/api/prospeccao/post_prospection_filters.md): Salva um conjunto de filtros para reutilização posterior.

Permite armazenar filtros complexos de pessoas ou empresas para uso recorrente.

## Listar filtros salvos de pessoas

 - [GET /prospection/filters/list_person](https://docs.datastone.com.br/api/prospeccao/get_prospection_filters_person.md): Recupera todos os filtros salvos para prospecção de pessoas

## Listar filtros salvos de empresas

 - [GET /prospection/filters/list_company](https://docs.datastone.com.br/api/prospeccao/get_prospection_filters_company.md): Recupera todos os filtros salvos para prospecção de empresas