Busca Pessoas

POST https://api.datastone.com.br/v1/b2b/persons/

Endpoint para prospecção B2B de pessoas físicas (PF). Permite buscar profissionais com base em filtros de perfil profissional e características da empresa onde trabalham.

Integração recomendada: Cada registro retornado contém um campo id_pessoa, que pode ser utilizado no endpoint de Enriquecimento de Pessoas para obter dados completos e atualizados sobre o mesmo indivíduo.

❗️

IMPORTANTE

Primeira requisição (sem cache_chave): 1 crédito B2B.

Paginação (com cache_chave): 0 créditos

O cache expira após 7 dias

Campos de Paginação

Os campos de paginação controlam a quantidade e a posição dos resultados retornados pela API.

Campo	Tipo	Obrigatório	Descrição
pagina	int	Sim	Número da página atual (mínimo: 1)
por_pagina	int	Sim	Quantidade de itens por página (mín: 1, máx: 50)
chave_cache	string	Altamente recomendado	Chave de cache retornada na primeira requisição para navegação sem cobrança

Filtros de Pessoa (filtros_pessoa)

Permite refinar a busca de pessoas aplicando critérios específicos de perfil profissional.

Campo	Tipo	Descrição	Valores Aceitos / Exemplo
departamentos	list[string]	Departamentos onde a pessoa trabalha ou já trabalhou	["Administrativo", "Engenharia", "TI", "Vendas", "Marketing", "Financeiro", "RH", "Operações", "Jurídico"]
niveis_senioridade	list[string]	Níveis hierárquicos e de experiência profissional	["Estagiário/Trainee", "Junior", "Pleno", "Senior", "Decisores"]
cargos	list[string]	Cargos ou funções específicas exercidas pela pessoa	["Desenvolvedor", "Gerente de Projetos", "Analista", "Coordenador", "Diretor"]
habilidades	list[string]	Habilidades técnicas ou profissionais	["Python", "Django", "React", "JavaScript", "AWS", "Gestão de Projetos"]
periodos_trabalho	list[string]	Tempo de permanência na empresa atual	["Menos de um ano", "De 1 a 2 anos", "De 3 a 5 anos", "Mais de 5 anos"]
localizacoes	list[string]	Cidades de acordo com as opções de filtro	["São Paulo, SP"]
estados	list[string]	Estados de acordo com as opções de filtro	["RJ", "MG"]
tem_email	bool	Filtrar apenas contatos com email disponível	true / false
tem_telefone	bool	Filtrar apenas contatos com telefone disponível	true / false
tem_cnpj	bool	Filtrar apenas empresas com CNPJ disponível	true / false
tem_linkedin	bool	Filtrar apenas contatos com perfil LinkedIn disponível	true / false

Filtros de Empresa (filtros_empresa)

Permite refinar a busca com detalhes de empresa ou pessoas de uma determinada empresa.

Campo	Tipo	Descrição	Valores Aceitos / Exemplo
nome_empresa	list[string]	Nomes de empresas específicas	["Google Brasil Internet Ltda", "Microsoft Brasil"]
localizacoes	list[string]	Cidades onde a empresa está localizada	["São Paulo, SP", "Rio de Janeiro, RJ"]
estados	list[string]	Estados (UF) onde a empresa possui filiais	["SP", "RJ", "MG"]
setores	list[string]	Setores de atuação da empresa	["Tecnologia", "Educação", "Saúde"]
atividades_cnae	list[string]	Códigos CNAE específicos	["6201500", "6202300"]
especialidades	list[string]	Especialidades ou nichos de atuação	["Software", "Consultoria"]
tamanhos_empresa	list[string]	Faixas de tamanho por número de funcionários	["0-1", "2-10", "11-50", "51-200"]
naturezas_juridicas	list[int]	IDs de naturezas jurídicas	[1, 2, 3]
tipos_trabalho	list[string]	Tipos de organização	["Empresa Privada", "Empresa Pública"]
data_fundacao	object	Período de fundação da empresa	{"data_inicio": "2010-01-01", "data_fim": "2023-12-31"}
faixa_receita	object	Faixa de receita anual estimada	{"receita_minima": 100000, "receita_maxima": 5000000}
incluir_mei	bool	Incluir microempreendedores individuais (MEI)	true / false
tem_cnpj	bool	Filtrar apenas empresas com CNPJ disponível	true / false
tem_email	bool	Filtrar apenas empresas com email disponível	true / false
tem_telefone	bool	Filtrar apenas empresas com telefone disponível	true / false
tem_linkedin	bool	Filtrar apenas empresas com perfil LinkedIn disponível	true / false