Skip to content

Obter resultado da prospecção

Request

Recupera o resultado de um job de prospecção.

Quando o job está pronto, a resposta traz apenas a chave file com a URL do arquivo - não há campo status. Enquanto o job não termina, a API não devolve o file; faça polling ou use o webhook.

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

Security
ApiKeyAuth
Path
job_idintegerrequired

ID do job de prospecção

Example:12345
curl -i -X GET \
  https://docs.datastone.com.br/_mock/api/prospection/12345/result/ \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Resultado retornado com sucesso

Bodyapplication/json
filestring

URL temporária para download do resultado da prospecção.

Para jobs de empresa o download é um ZIP contendo o arquivo principal prospeccao_{AAAAMMDD_HHMM}_{batch_id} e, somente se a prospecção encontrar sócios, um socios_{AAAAMMDD_HHMM}_{batch_id} com os sócios (CPF, cargo, % de participação, telefones e e-mails), sem custo adicional. Sem sócios, o ZIP vem só com o arquivo principal.

A extensão segue o file_formatting do job: excel (padrão da prospecção de empresas) gera .xlsx; csv gera .csv.

Se o job usou cbo_codes, o ZIP traz ainda um terceiro arquivo, empregados_{AAAAMMDD_HHMM}_{batch_id}.

Example:"https://storage.datastone.com.br/prospection/results/12345-resultado.csv?token=abc123&expires=1769448958"
Response
{ "file": "https://storage.datastone.com.br/prospection/results/12345-resultado.csv?token=abc123&expires=1769448958" }