API Documentation

Integre dados empresariais no seu sistema em minutos.

Base URL: https://api.datasocio.com.br

Autenticacao

Obrigatorio: Todas as requisicoes exigem autenticacao via API key ou JWT token no header Authorization. Requisicoes sem autenticacao retornam 401.

# API Key (recomendado para integracao)
curl -H "Authorization: Bearer vd_live_abc123..." \
https://api.datasocio.com.br/v1/empresas/33000167000101

# JWT Token (sessao do frontend)
curl -H "Authorization: Bearer eyJhbG..." \
https://api.datasocio.com.br/v1/search?q=petrobras

Crie sua conta e API key em datasocio.com.br/register ou no painel de billing.

Rate Limits e Creditos

Plano	Preco	Req/min	Creditos/mes
Gratuito	R$0	10	100
Profissional	R$197/mes	60	5.000
Enterprise	R$997/mes	300	Ilimitado

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-Quota-Used, X-Quota-Limit

Formatos de Data

Tipo	Formato	Exemplo
Datas (geral)	dd/MM/yyyy	14/01/1991
data_ajuizamento (processos)	yyyy-MM-dd	2023-05-10
Timestamps	ISO 8601	2026-04-05T12:00:00.000Z

Campos como dataAbertura, dataEntrada usam dd/MM/yyyy. O campo dataDistribuicao em processos usa yyyy-MM-dd. Campos como computedAt usam ISO 8601.

Creditos por Operacao

Cada operacao consome creditos do seu plano mensal. O custo e informado no header X-Credits-Cost e no campo meta.creditsCost de responses paginados.

Operacao	Creditos	Observacao
Busca basica (/v1/search, /v1/empresas/filtrar)	0	Gratuito
Busca com fields=full	1 por resultado	100 resultados = 100 creditos
Detalhe empresa (/v1/empresas/:cnpj)	1	Dados completos
Socios (/v1/empresas/:cnpj/socios)	1	Quadro societario
Compliance (/v1/compliance/:id)	1	PEP, sancoes, divida ativa
Processos judiciais	1	e-SAJ ou DataJud
Chat IA (/v1/chat)	1	DeepSeek
Estimativa faturamento	1	Modelo heuristico
Empresas similares	1	Mesmo CNAE+porte+UF
Enrichment (redes sociais)	2	Instagram, Google, RA
Grafo de relacionamentos	2	Ate 3 niveis
Batch enrich (por CNPJ)	1	Ate 100 CNPJs
Autocomplete (CNAEs, cidades)	0	Gratuito
Health check	0	Gratuito

Endpoints (32)

GET/v1/search

Buscar empresas por nome, CNPJ ou socio

Parametro	Obrigatorio	Descricao
q	Sim	Termo de busca: nome da empresa, CNPJ (8-14 digitos) ou nome de socio
type	Nao	Tipo: 'empresa' (default) ou 'socio'
uf	Nao	Filtro por estado (ex: SP, RJ, MG)
cnae	Nao	Filtro por CNAE (ex: 4754 ou 4754701)
situacao	Nao	Filtro: 'ativa', 'baixada', 'suspensa', 'inapta', 'todas' (default: todas)
porte	Nao	Filtro: 'ME' (Micro), 'EPP', '01', '03', '05' (Demais)
cidade	Nao	Filtro por cidade (ex: SAO PAULO)
aberturaFrom	Nao	Data minima de abertura (yyyy-MM-dd)
aberturaTo	Nao	Data maxima de abertura (yyyy-MM-dd)
simples	Nao	Optante Simples: 'sim' ou 'nao'
page	Nao	Pagina (default: 1)
limit	Nao	Resultados por pagina (default: 20, max: 100)

/v1/search?q=restaurante&uf=SP&porte=ME&situacao=ativa&aberturaFrom=2024-01-01&limit=5

Response:

{
  "data": [{
    "cnpj": "33000167000101",
    "cnpjFormatado": "33.000.167/0001-01",
    "razaoSocial": "PETROLEO BRASILEIRO S A PETROBRAS",
    "nomeFantasia": "PETROBRAS",
    "situacao": "Ativa",
    "dataAbertura": "28/09/1953",
    "cnaePrincipal": "0600001",
    "cnaeDescricao": "Extracao de petroleo e gas natural",
    "uf": "RJ",
    "municipio": "RIO DE JANEIRO",
    "porte": "Demais",
    "capitalSocial": "R$ 205.431.960.490,52"
  }, ...],
  "meta": { "total": 42, "page": 1, "pages": 3, "limit": 20 }
}

GET/v1/empresas/filtrar

Buscar empresas por filtros (sem texto de busca). Suporta fields=full para dados completos.

Parametro	Obrigatorio	Descricao
cnae	Nao	CNAE principal (ex: 4754 = moveis)
uf	Nao	Estado (ex: SP)
cidade	Nao	Nome da cidade (ex: BAURU)
cidadeCodigo	Nao	Codigo IBGE do municipio
situacao	Nao	'ativa', 'baixada', 'suspensa', 'inapta', 'todas' ou codigo (02, 08...)
porte	Nao	'ME', 'EPP', '01', '03', '05' (Demais). Aceita codigo ou alias.
fundacao	Nao	Abertas nos ultimos N anos (1, 3, 5, 10). Alias: 'abertura'
fields	Nao	'full' = retorna dados completos (endereco, socios, natureza juridica). Cobra 1 credito/resultado. Sem fields = dados basicos (0 creditos).
deduplicate	Nao	Excluir CNPJs ja enviados ao usuario (default: true). Rastreia por user_id. Use false para ver todos.
page	Nao	Pagina (default: 1)
limit	Nao	Limite (default: 20, max: 100)

/v1/empresas/filtrar?cnae=5611&uf=SP&cidade=BAURU&situacao=ativa&fundacao=1&fields=full&limit=5

Response:

{
  "data": [{
    "cnpj": "65670822000125",
    "cnpjFormatado": "65.670.822/0001-25",
    "razaoSocial": "ANA FLAVIA SIQUEIRA BUENO ESPETINHOS LTDA",
    "nomeFantasia": null,
    "situacao": "Ativa",
    "dataAbertura": "13/03/2026",
    "cnaePrincipal": "5611201",
    "cnaeDescricao": "Restaurantes e similares",
    "uf": "SP",
    "municipio": "BAURU",
    "porte": "ME",
    "capitalSocial": "R$ 50.000,00",
    "telefone": "(14) 32371236",
    "email": "restaurante@email.com",
    // Campos extras com fields=full:
    "naturezaJuridica": "Sociedade Empresária Limitada",
    "contato": { "telefone1": "(14) 32371236", "telefone2": null, "email": "..." },
    "endereco": { "tipoLogradouro": "RUA", "logradouro": "PEDRO LIRA", "numero": "195", "complemento": null, "bairro": "CENTRO", "cep": "17015020", "cidade": "BAURU", "uf": "SP" },
    "socios": [{ "nome": "ANA FLAVIA SIQUEIRA BUENO", "cpfCnpj": "***123456**", "qualificacao": "Socio-Administrador" }]
  }],
  "meta": {
    "total": 18,
    "page": 1,
    "pages": 4,
    "limit": 5,
    "fields": "full",
    "creditsPerResult": 1,
    "creditsCost": 5,
    "deduplicated": true,
    "filtros": { "cnae": "5611", "uf": "SP", "cidade": "BAURU", "situacao": "02" }
  }
}

GET/v1/empresas/:cnpj

Dados completos de uma empresa

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ com 14 digitos (com ou sem formatacao)

/v1/empresas/33000167000101

Response:

{
  "data": {
    "cnpj": "33000167000101",
    "cnpjFormatado": "33.000.167/0001-01",
    "razaoSocial": "PETROLEO BRASILEIRO S.A. PETROBRAS",
    "nomeFantasia": "PETROBRAS",
    "situacao": "Ativa",
    "naturezaJuridica": "Sociedade de Economia Mista",
    "capitalSocial": "R$ 205.431.960.490,52",
    "porte": "Demais",
    "dataAbertura": "28/09/1953",
    "cnaePrincipal": "0600001",
    "cnaeDescricao": "Extracao de petroleo e gas natural",
    "cnaesSecundarios": [
      { "codigo": "0600002", "descricao": "..." },
      ...
    ],
    "uf": "RJ",
    "municipio": "RIO DE JANEIRO",
    "endereco": {
      "tipoLogradouro": "AVENIDA",
      "logradouro": "REPUBLICA DO CHILE",
      "numero": "65",
      "complemento": null,
      "bairro": "CENTRO",
      "cep": "20031912",
      "cidade": "RIO DE JANEIRO",
      "uf": "RJ"
    },
    "contato": {
      "telefone1": "(21) 3224-1234",
      "telefone2": null,
      "fax": null,
      "email": "petrobras@petrobras.com.br"
    },
    "simples": {
      "opcaoSimples": false,
      "opcaoMei": false
    },
    "inscricoesEstaduais": [ ... ],
    "suframa": null,
    "socios": [
      {
        "nome": "MAGDA MARIA DE REGINA CHAMBRIARD",
        "cpfCnpj": "***038788**",
        "qualificacao": "Diretor",
        "dataEntrada": "14/06/2024",
        "faixaEtaria": "61-70"
      },
      ...
    ]
  }
}

GET/v1/empresas/:cnpj/enrichment

Dados enriquecidos: redes sociais, reputacao, website

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ com 14 digitos

/v1/empresas/33000167000101/enrichment

Response:

{
  "data": {
    "status": "available",
    "website": {
      "domain": "petrobras.com.br",
      "reachable": true,
      "title": "Petrobras",
      "phones": ["2132241234", "8003001001"],
      "emails": ["contato@petrobras.com.br", "ouvidoria@petrobras.com.br"],
      "whatsapp": "552132241234"
    },
    "socialMedia": {
      "instagram": { "handle": "petrobras", "followers": 4200000, "bio": "Energia para mover o Brasil", "verified": true },
      "linkedin": "petrobras",
      "facebook": "petrobras",
      "twitter": "petaborasbr",
      "youtube": "@petrobras"
    },
    "reclameAqui": {
      "score": 7.2,
      "totalComplaints": 1842,
      "resolvedPct": 82.4,
      "wouldBuyAgain": 56.7,
      "status": "Bom"
    },
    "riskScore": {
      "overall": 847,
      "cadastral": 950,
      "financial": 850,
      "reputation": 720,
      "social": 650,
      "factors": { "situacao": "02", "idadeAnos": 73, "capitalSocial": 205431960490.52 },
      "computedAt": "2026-04-05T12:00:00.000Z"
    }
  }
}

GET/v1/empresas/:cnpj/risk

Score de risco detalhado (0-1000)

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ

/v1/empresas/33000167000101/risk

Response:

{
  "data": {
    "overall": 847,
    "cadastral": 950,
    "financial": 850,
    "reputation": 720,
    "social": 650,
    "factors": {
      "situacao": "02",
      "idadeAnos": 73,
      "capitalSocial": 205431960490.52,
      "reclameAqui": 7.2,
      "website": true,
      "instagram": true,
      "linkedin": true
    },
    "computedAt": "2026-04-05T12:00:00.000Z"
  }
}

GET/v1/empresas/:cnpj/estimativa

Faturamento anual estimado (modelo heuristico)

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ

/v1/empresas/33000167000101/estimativa

Response:

{ "data": { "faturamentoEstimado": "R$ 249.600.000", "confianca": 0.6, "aviso": "Valor estimado..." } }

GET/v1/empresas/:cnpj/similares

Empresas similares (mesmo CNAE, porte, UF)

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ da empresa referencia
limit	Nao	Quantidade (default: 20, max: 100)

/v1/empresas/33000167000101/similares?limit=5

GET/v1/empresas/:cnpj/graph

Grafo de relacionamentos societarios

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ
depth	Nao	Profundidade: 1, 2 ou 3 (default: 1)

/v1/empresas/33000167000101/graph?depth=2

Response:

{
  "data": {
    "nodes": [
      { "id": "emp-33000167", "label": "PETROLEO BRASILEIRO S.A.", "type": "empresa", "cnpj": "33.000.167/0001-01" },
      { "id": "pes-1", "label": "MAGDA MARIA DE REGINA CHAMBRIARD", "type": "pessoa", "cpf": "***038788**" },
      { "id": "emp-03500167", "label": "TRANSPETRO S.A.", "type": "empresa" },
      ...
    ],
    "edges": [
      { "source": "pes-1", "target": "emp-33000167", "label": "Diretor" },
      { "source": "pes-1", "target": "emp-03500167", "label": "Conselheiro" },
      ...
    ]
  },
  "meta": { "cnpj": "33.000.167/0001-01", "depth": 2, "totalNodes": 5, "totalEdges": 4 }
}

GET/v1/compliance/:identifier

Score de compliance (PEP, sancoes, divida ativa, protestos)

Parametro	Obrigatorio	Descricao
identifier	Sim	CNPJ, CPF ou nome
type	Nao	'pj' ou 'pf' (auto-detectado)

/v1/compliance/33000167000101

Response:

{ "score": 1000, "riskLevel": "baixo", "checks": [{ "source": "OFAC", "status": "limpo" }, ...] }

GET/v1/pessoas/:nome

Perfil de pessoa fisica (socio): empresas, processos, PEP, score

Parametro	Obrigatorio	Descricao
nome	Sim	Nome completo (URL encoded)
cpf	Nao	CPF mascarado para filtro (*123456)

/v1/pessoas/MAGDA%20MARIA%20DE%20REGINA%20CHAMBRIARD

Response:

{
  "data": {
    "nome": "MAGDA MARIA DE REGINA CHAMBRIARD",
    "cpfMasked": "***038788**",
    "totalEmpresas": 3,
    "empresasAtivas": 2,
    "empresasBaixadas": 1,
    "primeiraSociedade": "2005-03-15",
    "empresas": [
      {
        "cnpj": "33000167000101",
        "cnpjBasico": "33000167",
        "razaoSocial": "PETROLEO BRASILEIRO S.A.",
        "nomeFantasia": "PETROBRAS",
        "qualificacao": "Diretor",
        "dataEntrada": "2024-06-14",
        "situacao": "Ativa",
        "uf": "RJ",
        "municipio": "RIO DE JANEIRO",
        "capitalSocial": "R$ 205.431.960.490,52",
        "capitalSocialNumero": 205431960490.52,
        "porte": "Demais",
        "cnaePrincipal": "0600001",
        "cnaeDescricao": "Extracao de petroleo e gas natural"
      },
      ...
    ],
    "isPep": true,
    "pepCargo": "Diretor de empresa estatal",
    "pepOrgao": "Petrobras",
    "isSanctioned": false,
    "sancoes": [],
    "totalProcessos": 2,
    "processos": [
      {
        "numero": "1234567-89.2023.8.26.0100",
        "tribunal": "TJSP",
        "tipo": "Procedimento Comum Civel",
        "assunto": "Responsabilidade Civil",
        "valorCausa": "R$ 500.000",
        "dataDistribuicao": "2023-05-10",
        "status": "Em andamento",
        "polo": "reu",
        "resumoIA": "Acao de indenizacao por danos morais...",
        "modeloIA": "claude-haiku-4-5-20251001",
        "partes": [
          {
            "nome": "JOAO SILVA",
            "polo": "autor",
            "tipoPessoa": "fisica",
            "documento": "***123456**",
            "cnpjVinculado": null,
            "razaoSocialVinculada": null,
            "situacaoVinculada": null,
            "matchScore": 0.95,
            "matchMethod": "exact",
            "advogados": ["Dr. Fulano de Tal"]
          },
          ...
        ]
      },
      ...
    ],
    "score": 720,
    "scoreFactors": {
      "empresasAtivas": 2,
      "empresasBaixadas": 1,
      "processosReu": 1,
      "processosAutor": 1,
      "criminal": false,
      "pep": true,
      "sancionado": false,
      "protestos": 0,
      "anosSociedade": 21
    },
    "rendaEstimada": null,
    "enrichmentStatus": "available"
  }
}

GET/v1/processos/buscar

Buscar processos judiciais em 8 tribunais e-SAJ

Parametro	Obrigatorio	Descricao
nome	Nao	Nome da pessoa (obrigatorio se nao enviar cpf)
cpf	Nao	CPF (obrigatorio se nao enviar nome)
tribunal	Nao	Filtrar por tribunal (ex: TJSP)

/v1/processos/buscar?nome=JOAO+SILVA

GET/v1/processos/brasil

Buscar processos em TODOS os 35 tribunais (DataJud/CNJ)

Parametro	Obrigatorio	Descricao
nome	Nao	Nome (obrigatorio se nao enviar cpf/cnpj)
cpf	Nao	CPF
cnpj	Nao	CNPJ

/v1/processos/brasil?nome=JOAO+SILVA

POST/v1/batch/enrich

Enriquecimento em lote — retorna dados completos de ate 100 CNPJs em 1 request. Cobra 1 credito por CNPJ encontrado.

Parametro	Obrigatorio	Descricao
cnpjs	Sim	Array de CNPJs: ["33000167000101", "60746948000112"]. Max 100.

POST /v1/batch/enrich
Body: { "cnpjs": ["33000167000101", "60746948000112"] }

Response:

{
  "data": [
    { "cnpj": "33000167000101", "razaoSocial": "PETROLEO BRASILEIRO S A PETROBRAS", "situacao": "Ativa", "endereco": {...}, "contato": {...}, "socios": [...], ... },
    { "cnpj": "60746948000112", "razaoSocial": "BANCO BRADESCO S.A.", ... }
  ],
  "meta": { "total": 2, "encontrados": 2, "erros": 0 }
}

POST/v1/chat

IA conversacional sobre empresas (DeepSeek)

Parametro	Obrigatorio	Descricao
message	Sim	Pergunta em linguagem natural
context.cnpj	Nao	CNPJ para contexto

POST /v1/chat
Body: { "message": "Qual o risco da Petrobras?", "context": { "cnpj": "33000167000101" } }

GET/v1/maps/stats

Estatisticas de empresas por UF

/v1/maps/stats

GET/v1/maps/heatmap

Densidade de empresas por municipio

Parametro	Obrigatorio	Descricao
uf	Nao	Filtrar por estado
cnae	Nao	Filtrar por CNAE
situacao	Nao	Filtrar: 'ativa' (default: todas)

/v1/maps/heatmap?uf=SP&cnae=62&situacao=ativa

POST/v1/monitoring

Monitorar CNPJ para mudancas

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ a monitorar
webhookUrl	Nao	URL para receber alertas
email	Nao	Email para receber alertas
fields	Nao	Campos a monitorar (default: ["situacao_cadastral","socios","endereco"])

POST /v1/monitoring
Body: { "cnpj": "33000167000101", "webhookUrl": "https://meusite.com/webhook", "fields": ["situacao_cadastral","socios"] }

GET/v1/filtros/cnaes

Autocomplete de CNAEs por texto

Parametro	Obrigatorio	Descricao
q	Sim	Texto para buscar (ex: 'moveis', 'restaurante')

/v1/filtros/cnaes?q=moveis

GET/v1/filtros/cidades

Autocomplete de cidades por texto (busca em 5.572 municipios)

Parametro	Obrigatorio	Descricao
q	Sim	Texto (min 2 chars)

/v1/filtros/cidades?q=sao+jose&uf=SP

GET/v1/empresas/:cnpj/socios

Quadro societario completo de uma empresa

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ com 14 digitos

/v1/empresas/33000167000101/socios

Response:

{
  "data": [
    {
      "nome": "MAGDA MARIA DE REGINA CHAMBRIARD",
      "cpfCnpj": "***038788**",
      "qualificacao": "Diretor",
      "dataEntrada": "14/06/2024",
      "faixaEtaria": "61-70"
    },
    {
      "nome": "FERNANDO ANTONIO RIBEIRO SOARES MELGAREJO",
      "cpfCnpj": "***521577**",
      "qualificacao": "Diretor",
      "dataEntrada": "02/01/2023",
      "faixaEtaria": "51-60"
    },
    ...
  ],
  "meta": { "total": 9, "cnpj": "33.000.167/0001-01" }
}

POST/v1/empresas/:cnpj/enrich

Disparar enriquecimento manual (Pro/Enterprise)

Parametro	Obrigatorio	Descricao
cnpj	Sim	CNPJ

POST /v1/empresas/33000167000101/enrich

GET/v1/processos/tribunais

Listar tribunais disponiveis (e-SAJ e DataJud)

/v1/processos/tribunais

POST/v1/batch/csv

Enriquecimento via upload CSV (coluna cnpj obrigatoria)

Parametro	Obrigatorio	Descricao
body	Sim	Texto CSV com header contendo coluna 'cnpj'. Max 100 linhas.

POST /v1/batch/csv
Content-Type: text/plain

cnpj
33000167000101
60746948000112

GET/v1/maps/empresas

Empresas por regiao (dados para mapa)

Parametro	Obrigatorio	Descricao
uf	Sim	Estado (ex: SP)
cidade	Nao	Nome da cidade
cnae	Nao	Filtro por CNAE
situacao	Nao	Filtro: 'ativa'
limit	Nao	Max resultados (default: 200, max: 1000)

/v1/maps/empresas?uf=SP&cidade=SAO+PAULO&cnae=62&situacao=ativa&limit=100

GET/v1/health

Status da API (publico, sem autenticacao)

/v1/health

Response:

{ "status": "ok", "timestamp": "..." }

POST/auth/register

Criar conta + plano gratuito + primeira API key

Parametro	Obrigatorio	Descricao
email	Sim	Email valido
name	Sim	Nome (min 2 chars)
password	Sim	Senha (min 8 chars)

POST /auth/register
Body: { "email": "user@email.com", "name": "Joao", "password": "minhasenha" }

Response:

{ "user": { "id": "...", "email": "..." }, "token": "eyJ...", "apiKey": "vd_live_..." }

POST/auth/login

Parametro	Obrigatorio	Descricao
email	Sim	Email
password	Sim	Senha

POST /auth/login
Body: { "email": "user@email.com", "password": "minhasenha" }

Response:

{ "user": {...}, "token": "eyJ...", "subscription": {...}, "apiKeys": [...] }

GET/auth/me

Validar sessao e obter dados do usuario logado

GET /auth/me
Authorization: Bearer eyJ...

GET/auth/api-keys

Listar API keys do usuario (sem revelar valor)

GET /auth/api-keys

POST/auth/api-keys

Gerar nova API key

Parametro	Obrigatorio	Descricao
name	Nao	Nome da key (default: 'Nova Key')

POST /auth/api-keys
Body: { "name": "Minha Key" }

Response:

{ "apiKey": "vd_live_...", "prefix": "vd_live_xxxx", "message": "Guarde — ela so aparece uma vez!" }

DELETE/auth/api-keys/:id

Revogar uma API key

Parametro	Obrigatorio	Descricao
id	Sim	ID da key (UUID)

DELETE /auth/api-keys/8e9383e4-d70d-4676-...

GET/auth/usage

Uso de creditos do mes atual

GET /auth/usage

Response:

{ "plan": "free", "used": 42, "limit": 100, "remaining": 58, "resetDate": "2026-05-01" }

Codigos de Erro

Codigo	Significado
400	Parametros invalidos ou ausentes
401	Autenticacao ausente ou token invalido
403	Creditos esgotados ou plano insuficiente
404	Recurso nao encontrado (CNPJ inexistente)
429	Rate limit excedido — aguarde X-RateLimit-Reset
500	Erro interno do servidor

Exemplo completo

// Node.js — Buscar empresas
const response = await fetch(
  'https://api.datasocio.com.br/v1/search?q=petrobras&limit=5',
  { headers: { 'Authorization': 'Bearer vd_live_...' } }
);
const { data, meta } = await response.json();
console.log(data[0].razaoSocial);  // "PETROLEO BRASILEIRO S A PETROBRAS"
console.log(meta.total);           // 42

// Filtrar por CNAE + cidade (sem texto de busca)
const res2 = await fetch(
  'https://api.datasocio.com.br/v1/empresas/filtrar?cnae=4754&uf=SP&cidade=BAURU&situacao=ativa&fundacao=1',
  { headers: { 'Authorization': 'Bearer vd_live_...' } }
);
// → 18 lojas de moveis abertas em Bauru no ultimo ano

// Compliance check
const res3 = await fetch(
  'https://api.datasocio.com.br/v1/compliance/33000167000101',
  { headers: { 'Authorization': 'Bearer vd_live_...' } }
);
// → { score: 1000, riskLevel: "baixo", checks: [...] }

// Chat IA
const res4 = await fetch(
  'https://api.datasocio.com.br/v1/chat',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer vd_live_...', 'Content-Type': 'application/json' },
    body: JSON.stringify({ message: 'Quantos socios tem a Petrobras?' })
  }
);
// → { reply: "A Petrobras tem 9 sócios..." }

Changelog

v1.4.02026-04-05

fields=full no /v1/empresas/filtrar — dados completos inline (endereco, socios, natureza juridica)
Tabela de creditos por operacao adicionada a documentacao
meta.creditsCost e meta.creditsPerResult documentados
Response do POST /v1/batch/enrich documentado com exemplo completo
Deduplicacao: detalhado que rastreia por user_id
Param porte aceita alias ME/EPP alem de codigos 01/03/05
Response completo do /v1/empresas/filtrar documentado com todos os campos
Rate limit: 20 req/min para frontend anonimo
Compliance, chat, processos, similares, estimativa agora cobram 1 credito

v1.3.12026-04-05

Documentacao reescrita: 33 endpoints documentados com params detalhados
Corrigido: depth default no graph era 2 na docs, 1 no codigo (agora correto: 1)
Corrigido: situacao aceita ativa/baixada/suspensa/inapta/todas (antes so ativa/02)
Corrigido: header X-Credits -> X-Quota (alinhado com codigo)
Adicionados endpoints faltantes: socios, enrich, tribunais, batch/csv, maps/empresas, auth/*, health
Removido param uf de filtros/cidades (nao tinha efeito no codigo)

v1.3.02026-04-05

Autenticacao obrigatoria em todos os endpoints (antes era opcional)
JWT nunca expira (antes expirava em 7 dias)
Novo endpoint: /v1/compliance/:identifier
Novo endpoint: /v1/empresas/:cnpj/estimativa
Novo endpoint: /v1/empresas/:cnpj/similares
Novo endpoint: /v1/maps/stats e /v1/maps/heatmap
Novo endpoint: /v1/chat (IA conversacional)
Novo endpoint: /v1/batch/enrich e /v1/batch/csv
CNAEs secundarios com descricao no detalhe da empresa
Inscricoes Estaduais e SUFRAMA no detalhe da empresa
Capital social e CNAE na listagem de sociedades
Busca por nome otimizada (FTS + trgm, 50x mais rapida)
Busca por filtros aceita situacao=ativa (texto) alem de 02 (codigo)

v1.2.02026-04-03

Rebrand: VeriData -> DataSocio
8 tribunais e-SAJ integrados
DataJud (35 tribunais) integrado
Enriquecimento de partes dos processos

v1.0.02026-04-01

Lancamento inicial
67M empresas da Receita Federal
Busca por CNPJ, nome, socio
Score de risco
API keys e planos

SDKs

Node.js / TypeScript

npm install @datasocio/sdkEm breve

Python

pip install datasocioEm breve

PHP

composer require datasocio/sdkEm breve

Precisa de ajuda?

Entre em contato: api@datasocio.com.br