> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/company/lookalike.md). # LookAlike ## LookAlike — empresas similares aos CNPJs de referência > Recebe N CNPJs \*\*case de sucesso\*\* e devolve empresas similares baseado\ > em perfil inferido automaticamente (CNAE, UF, porte).\ > \ > \### Fluxo\ > 1\. Buscamos cada CNPJ na base pública e extraímos \`cnae\_principal\`,\ > \`uf\`, \`porte\` de cada um.\ > 2\. Compomos filtros (união dos atributos) — por default, só ATIVAS.\ > 3\. Você pode sobrescrever via \`filtros\_override\` (ex.: restringir UF).\ > 4\. Buscamos empresas que casam com esses filtros.\ > 5\. Se \`save\_to\_base=true\`, inserimos como leads automaticamente\ > (idempotente — só insere as que ainda não estão na base do cliente).\ > \ > \### Casos de uso\ > \- Sales: cliente fechou com 5 empresas de CNAE X → quer +50 similares.\ > \- Marketing: pegar concorrentes diretos pra campanha segmentada.\ > \- Pipeline de prospecção: CSV de cases → enriquece com look-alikes\ > automaticamente no CRM externo.
```json {"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"Company","description":"**Enriquecimento de empresa por CNPJ.** Receba dados completos\n(razão social, endereço, CNAEs, sócios) e adicione automaticamente à sua base\nde leads quando ainda não existir.\n\n### Quando usar\n- Você tem o CNPJ e quer enriquecer com dados estruturados (cadastro, sócios).\n- Quer **adicionar empresa nova à sua base** automaticamente no primeiro lookup.\n- Pipeline de enriquecimento de leads (ex.: cliente envia CSV de CNPJs).\n\n### Quando NÃO usar\n- Listar muitas empresas já cadastradas → use [Lead](#tag/Lead) (`lead/list`).\n- Buscar por nome/razão → use [Lead](#tag/Lead) (`lead/search`).\n- Detalhe de empresa já existente sem novo lookup → use [Lead](#tag/Lead) (`lead/detail`).\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"responses":{"BadRequest":{"description":"Parâmetro obrigatório ausente ou em formato inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}}},"paths":{"/company/lookalike":{"post":{"tags":["Company"],"summary":"LookAlike — empresas similares aos CNPJs de referência","operationId":"companyLookalike","description":"Recebe N CNPJs **case de sucesso** e devolve empresas similares baseado\nem perfil inferido automaticamente (CNAE, UF, porte).\n\n### Fluxo\n1. Buscamos cada CNPJ na base pública e extraímos `cnae_principal`,\n `uf`, `porte` de cada um.\n2. Compomos filtros (união dos atributos) — por default, só ATIVAS.\n3. Você pode sobrescrever via `filtros_override` (ex.: restringir UF).\n4. Buscamos empresas que casam com esses filtros.\n5. Se `save_to_base=true`, inserimos como leads automaticamente\n (idempotente — só insere as que ainda não estão na base do cliente).\n\n### Casos de uso\n- Sales: cliente fechou com 5 empresas de CNAE X → quer +50 similares.\n- Marketing: pegar concorrentes diretos pra campanha segmentada.\n- Pipeline de prospecção: CSV de cases → enriquece com look-alikes\n automaticamente no CRM externo.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cnpjs"],"properties":{"cnpjs":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","minLength":14,"maxLength":14},"description":"1 a 50 CNPJs de referência (14 dígitos, sem máscara)."},"limit":{"type":"integer","default":50,"maximum":100,"description":"Quantas empresas retornar (cap 100)."},"save_to_base":{"type":"boolean","default":false,"description":"Se true, insere as encontradas na base do cliente como leads."},"filtros_override":{"type":"object","description":"Substitui filtros inferidos (ex. forçar UF específica).","properties":{"cnae":{"type":"array","items":{"type":"string"}},"uf":{"type":"array","items":{"type":"string"}},"porte":{"type":"array","items":{"type":"string"}},"cidade":{"type":"array","items":{"type":"string"}},"situacao":{"type":"array","items":{"type":"string"},"description":"Default ATIVA."}}}}}}}},"responses":{"200":{"description":"Empresas similares encontradas.","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"perfil_inferido":{"type":"object","properties":{"cnaes":{"type":"array","items":{"type":"string"}},"ufs":{"type":"array","items":{"type":"string"}},"portes":{"type":"array","items":{"type":"string"}}}},"cnpjs_referencia":{"type":"array","items":{"type":"string"}},"total_encontrados":{"type":"integer"},"leads_salvos":{"type":"integer","description":"Apenas se save_to_base=true."},"empresas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"cnpj":{"type":"string"},"razao_social":{"type":"string"},"nome_fantasia":{"type":"string"},"porte":{"type":"string"},"natureza_juridica":{"type":"string"},"uf":{"type":"string"},"cidade":{"type":"string"},"bairro":{"type":"string"},"cep":{"type":"string"},"situacao":{"type":"string"},"cnae_principal":{"type":"string"},"cnae_principal_descricao":{"type":"string"},"telefone_principal":{"type":"string"},"email_principal":{"type":"string","format":"email"},"capital_social":{"type":"number"},"quantidade_socios":{"type":"integer"},"data_abertura":{"type":"string","format":"date"},"site":{"type":"string","format":"uri","nullable":true}}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}} ```