Buscar pessoas B2B

Request

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.

Security

ApiKeyAuth

Bodyapplication/jsonrequired

paginainteger, >= 1required

Número da página. Campo obrigatório — não possui valor padrão.

Example:1

por_paginainteger, [ 1 .. 50 ]required

Itens por página. O contrato aceita de 1 a 50. Campo obrigatório — não possui valor padrão.

Aviso operacional: apesar de o contrato aceitar até 50, valores altos podem exceder o tempo de resposta e cair como erro de transporte (conexão encerrada antes da resposta HTTP, sem status). Isso já foi observado em produção com por_pagina: 25 neste endpoint. Se acontecer, reduza o valor ou pagine com chave_cache (paginação não consome créditos).

Example:20

chave_cachestring

Chave de cache (economiza créditos em requisições subsequentes)

Example:"abc123xyz"

filtros_pessoaobject(FiltrosPessoa)

filtros_empresaobject(FiltrosEmpresa)

url_webhookstring

URL para callback assíncrono

Example:"https://seusite.com/webhook"

curl -i -X POST \
  https://docs.datastone.com.br/_mock/api/b2b/persons/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "pagina": 1,
    "por_pagina": 20,
    "chave_cache": "abc123xyz",
    "filtros_pessoa": {
      "departamentos": [
        "Tecnologia",
        "Marketing"
      ],
      "niveis_senioridade": [
        "Sênior",
        "Pleno"
      ],
      "cargos": [
        "Desenvolvedor",
        "Gerente"
      ],
      "habilidades": [
        "Python",
        "JavaScript"
      ],
      "periodos_trabalho": [
        {}
      ],
      "localizacoes": [
        "São Paulo, SP"
      ],
      "estados": [
        "SP",
        "RJ"
      ],
      "has_email": true,
      "has_phone": true,
      "has_cnpj": true,
      "has_linkedin": true
    },
    "filtros_empresa": {
      "nome_empresa": [
        "Google Brasil Internet Ltda"
      ],
      "localizacoes": [
        "São Paulo, SP",
        "Rio de Janeiro, RJ"
      ],
      "estados": [
        "SP",
        "RJ"
      ],
      "setores": [
        "Tecnologia",
        "Educação"
      ],
      "atividades_cnae": [
        "1091102 - Fabricação de produtos de padaria e confeitaria"
      ],
      "especialidades": [
        "Software"
      ],
      "tamanhos_empresa": [
        "11-50",
        "51-200"
      ],
      "naturezas_juridicas": [
        1,
        2,
        3
      ],
      "tipos_trabalho": [
        "Empresa Privada"
      ],
      "data_fundacao": {
        "data_inicio": "2010-01-01",
        "data_fim": "2023-12-31"
      },
      "faixa_receita": {
        "receita_minima": 100000,
        "receita_maxima": 5000000
      },
      "incluir_mei": true,
      "tem_cnpj": true,
      "tem_email": true,
      "tem_telefone": true,
      "tem_linkedin": true,
      "setores_cnae": [
        "Informação e Comunicação"
      ],
      "filtro_exclusao_lista": true,
      "listas_contato": [
        1,
        2
      ]
    },
    "url_webhook": "https://seusite.com/webhook"
  }'

Responses

Pessoas encontradas com sucesso

Bodyapplication/json

sucessoboolean

Status de sucesso da requisição

Example:true

paginainteger

Página atual

Example:1

por_paginainteger

Itens por página

Example:20

chave_cachestring

Chave para usar em paginação (evita custos adicionais)

Example:"abc123xyz"

totalinteger

Total de resultados encontrados

Example:150

dadosArray of objects

Lista de pessoas encontradas

Response

{
  "sucesso": true,
  "pagina": 1,
  "por_pagina": 20,
  "chave_cache": "abc123xyz",
  "total": 150,
  "dados": [
    { … }
  ]
}