Skip to content

Data Intel da empresa (contexto de negócio)

Request

Contexto de negócio da empresa extraído do site institucional dela, em três blocos. É o mesmo conteúdo da aba Data Intel da plataforma.

  • dados_empresa — identificação e contatos publicados no site (nome, descrição, endereço, telefones, e-mails);

  • analise_negocio — o que a empresa faz: ramo de atividade, indústria, produtos e serviços, público-alvo, modelo de negócio e diferenciais;

  • analise_estrategica — leitura comercial para preparar a abordagem: mercado de atuação, ICP presumido, diferenciais, pontos de rapport, tipo de venda, presença digital e história da empresa.

Os textos são gerados por LLM a partir do conteúdo do site. Campo sem base no site vem null: trate como "não identificado", não como "não existe".

Cobrança — a mesma da plataforma. Na plataforma o Data Intel é cortesia em cima de uma consulta já paga. Aqui vale a mesma regra, com a carência de 24h por documento (escopo da conta, não do usuário):

  • CNPJ já cobrado pela conta nas últimas 24h (por /companies/ ou por este endpoint) → 0 créditos;

  • CNPJ ainda não cobrado na janela → 1 crédito, identificado no extrato como Data Intel — e a consulta cadastral do mesmo CNPJ nas 24h seguintes também não cobra;

  • nada entregue, nada cobrado: status diferente de ready é sempre gratuito.

Primeira consulta de um site novo devolve processing: a análise entra na fila e costuma ficar pronta em poucos minutos. Repita a chamada (também gratuita) para obter o resultado.

Security
ApiKeyAuth
Query
cnpjstring^\d{14}$required

CNPJ da empresa. Envie sempre o documento completo, com os zeros à esquerda; a API normaliza a entrada para dígitos.

Example:cnpj=12345678000199
curl -i -X GET \
  'https://api.datastone.com.br/v1/company/intel/?cnpj=12345678000199' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Consulta realizada. Confira status antes de usar intel, e charged para saber se houve débito.

Bodyapplication/json
cnpjstring
Example:"12345678000199"
company_namestring

Razão social da empresa consultada

statusstring

ready = há contexto em intel; processing = análise do site enfileirada, tente de novo em alguns minutos; unavailable = a empresa não tem site/LinkedIn utilizável ou o site não produziu dado analisável.

Enum:"ready""processing""unavailable"
sourcestring or null

De onde o contexto foi extraído

Enum:"site""linkedin"null
domainstring or null
intelobject or null

Contexto extraído. Presente apenas com status=ready. Todo campo de texto é gerado por LLM a partir do site e pode vir null quando o site não sustenta a conclusão — trate campo ausente como "não identificado", não como "não existe".

messagestring or null

Explicação quando não há contexto a entregar

chargedboolean

Se esta chamada debitou crédito

creditsinteger

Créditos debitados nesta chamada (0 quando gratuita)

reasonstring

Por que cobrou ou não: data_intel = cobrou pelo contexto; consulta_ja_cobrada = CNPJ dentro da carência de 24h; sem_dado = nada foi entregue.

Enum:"data_intel""consulta_ja_cobrada""sem_dado"
Response
{
  "cnpj": "12345678000199",
  "company_name": "TRANSLOG SOLUCOES LOGISTICAS LTDA",
  "status": "ready",
  "source": "site",
  "domain": "translog.com.br",
  "intel": {
    "domain": "translog.com.br",
    "cnpj": "12.345.678/0001-99",
    "logo": { … },
    "dados_empresa": { … },
    "analise_negocio": { … },
    "analise_estrategica": { … },
    "social_media": { … },
    "executive_summary": "Operadora logística B2B focada em saúde e agronegócio, com frota própria e três centros de distribuição."
  },
  "message": null,
  "charged": true,
  "credits": 1,
  "reason": "data_intel"
}