Permite buscar empresas com base em filtros de localização, setor, tamanho, receita anual, CNAE, natureza jurídica, data de fundação, e outros identificadores diretos como CNPJ ou URL do perfil do LinkedIn.
Overview
A API de Prospecção B2B (PJ) realiza consultas em tempo real combinando dados públicos, registros oficiais e informações atualizadas por meio de monitoramento automático de fontes como LinkedIn e bases empresariais.
Permite iniciar o enriquecimento de uma empresa a partir do número de CNPJ.
Permite identificar e enriquecer uma empresa a partir da URL do perfil institucional no LinkedIn. Quando disponível, o sistema ativa o job de atualização automática para manter o perfil da empresa sincronizado em tempo real com o LinkedIn (nome, descrição, número de funcionários, logotipo e outros dados públicos).
Permite iniciar o enriquecimento de uma empresa a partir de um identificador de empresa.
Busca empresas aplicando filtros de perfil e características empresariais.
Importante — Sistema de Cache e Cobrança
O endpoint utiliza um sistema de cache para paginação que economiza créditos:
- Primeira requisição (sem
cache_chave): executa a query, cobra 1 crédito B2B e retornacache_chave.- Requisições subsequentes (com
cache_chave): usam o cache, sem custo adicional.- O cache expira após algumas horas.
Se o
cache_chavenão for informado nas páginas seguintes, será cobrado novamente.
// Busca unitaria
{
"contato": {
"url_linkedin": "https://www.linkedin.com/in/company/teste-example/"
},
"url_webhook": "https://api-external.com/webhook/callback"
}
// Busca em Lote
{
"contato": [
{ "url_linkedin": "https://www.linkedin.com/in/company/teste-example-1/"},
{ "url_linkedin": "https://www.linkedin.com/in/company/teste-example-2/"},
{ "url_linkedin": "https://www.linkedin.com/in/company/teste-example-3/"}
],
"url_webhook": "https://api-external.com/webhook/callback"
}// Busca unitaria
{
"contato": {
"cnpj": 12345678901234
},
"url_webhook": "https://api-external.com/webhook/callback"
}
// Busca em lote
{
"contato": [
{ "cnpj": 12345678901234},
{ "cnpj": 32198765432141},
{ "cnpj": 01223151789123}
],
"url_webhook": "https://api-external.com/webhook/callback"
}// Busca unitaria
{
"contato": {
"empresa_id": 123456
},
"url_webhook": "https://api-external.com/webhook/callback"
}
// Busca em lote
{
"contato": [
{ "empresa_id": 123456},
{ "empresa_id": 78910},
{ "empresa_id": 111213}
],
"url_webhook": "https://api-external.com/webhook/callback"
}{
"pagina": 1,
"por_pagina": 20,
"filtros_empresa": {
"nome_empresa": [
"Google Brasil"
],
"setores": [
"Tecnologia"
],
"portes_empresa": [
"51-200",
"201-500"
],
"atividades_cnae": [
"6201-5/00"
],
"setores_cnae": [
"Informação e comunicação"
],
"especialidades": [
"Software"
],
"naturezas_juridicas": [
2
],
"tipos_trabalho": [
"Empresa Privada"
],
"data_fundacao": {
"data_inicio": "2010-01-01",
"data_fim": "2023-12-31"
},
"faixa_faturamento": {
"faturamento_minimo": 100000,
"faturamento_maximo": 5000000
},
"incluir_mei": false
}
}