Documentação da cnpjob API

[
  {
    "id": 1,
    "name": "Free",
    "slug": "free",
    "price_brl": "0.00",
    "req_per_day": 10,
    "req_per_min": 2,
    "max_page_size": 10,
    "has_checkout": false
  },
  {
    "id": 2,
    "name": "Pro",
    "slug": "pro",
    "price_brl": "99.90",
    "req_per_day": 10000,
    "req_per_min": 60,
    "max_page_size": 100,
    "has_checkout": true
  }
]

curl https://api.cnpjob.com.br/cnpj/validate/33000167000101

curl https://api.cnpjob.com.br/cnpj/33000167000101 \
  -H "X-API-Key: cnjb_live_SUA_CHAVE"

{
  "cnpj": "33.000.167/0001-01",
  "razao_social": "PETROLEO BRASILEIRO S A PETROBRAS",
  "nome_fantasia": "PETROBRAS",
  "situacao_cadastral": "Ativa",
  "data_situacao": "2005-11-17",
  "data_abertura": "1966-09-28",
  "porte": "Grande",
  "natureza_juridica": "Sociedade de Economia Mista",
  "capital_social": 205431960490.52,
  "cnae_principal": {
    "codigo": "0600301",
    "descricao": "Extração de petróleo e gás natural"
  },
  "cnaes_secundarios": [
    { "codigo": "1921700", "descricao": "Fabricação de produtos do refino de petróleo" }
  ],
  "endereco": {
    "logradouro": "AV REPUBLICA DO CHILE",
    "numero": "65",
    "complemento": "ANDAR 1 A 22",
    "bairro": "CENTRO",
    "municipio": "RIO DE JANEIRO",
    "uf": "RJ",
    "cep": "20031912"
  },
  "telefone": "2135985678",
  "email": "relacionamento@petrobras.com.br",
  "socios": [
    {
      "nome": "MAGDA MARIA DE REGINA CHAMBRIARD",
      "qualificacao": "Presidente",
      "tipo": "Pessoa Física",
      "cpf_representante": null
    }
  ]
}

curl https://api.cnpjob.com.br/cnpj/33000167000101/socios \
  -H "X-API-Key: cnjb_live_SUA_CHAVE"

[
  {
    "nome": "MAGDA MARIA DE REGINA CHAMBRIARD",
    "cpf_cnpj": "***355***-**",
    "qualificacao": "Presidente",
    "tipo": "Pessoa Física",
    "data_entrada": "2023-06-21"
  }
]

{
  "cnpjs": ["33000167000101", "00000000000191"]
}

curl -X POST https://api.cnpjob.com.br/cnpj/batch \
  -H "X-API-Key: cnjb_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["33000167000101","00000000000191"]}'

{
  "total": 48,
  "data": [
    {
      "cnpj": "33.000.167/0001-01",
      "nome_fantasia": "PETROBRAS - MATRIZ",
      "situacao": "Ativa",
      "tipo": "Matriz",
      "uf": "RJ",
      "municipio": "RIO DE JANEIRO"
    }
  ]
}

curl "https://api.cnpjob.com.br/empresa/busca?q=petrobras&limit=5" \
  -H "X-API-Key: cnjb_live_SUA_CHAVE"

{
  "query": "petrobras",
  "page": 1,
  "limit": 5,
  "total": 12,
  "empresas": [
    {
      "cnpj": "33.000.167/0001-01",
      "razao_social": "PETROLEO BRASILEIRO S A PETROBRAS",
      "situacao": "Ativa",
      "uf": "RJ",
      "municipio": "RIO DE JANEIRO",
      "cnae_principal": "0600301"
    }
  ]
}

curl "https://api.cnpjob.com.br/empresas?cnae=6201501&uf=SP&situacao=ativa&limit=50" \
  -H "X-API-Key: cnjb_live_SUA_CHAVE"

{
  "page": 1,
  "limit": 50,
  "total": 50,
  "empresas": [
    {
      "cnpj": "00.000.000/0001-00",
      "razao_social": "EMPRESA TECH LTDA",
      "situacao": "Ativa",
      "uf": "SP",
      "municipio": "SAO PAULO",
      "cnae_principal": "6201501"
    }
  ]
}

curl "https://api.cnpjob.com.br/socio/busca?cpf_cnpj=12345678901" \
  -H "X-API-Key: cnjb_live_SUA_CHAVE"

[
  {
    "cnpj": "12.345.678/0001-90",
    "razao_social": "EMPRESA EXEMPLO LTDA",
    "situacao": "Ativa",
    "nome_socio": "FULANO DE TAL",
    "qualificacao": "Sócio-Administrador"
  }
]

curl -X POST "https://api.cnpjob.com.br/api/portal/leads/search" \
  -H "Authorization: Bearer SEU_JWT" \
  -H "Content-Type: application/json" \
  -d '{"cnae":"8630501","uf":"SP","situacao":"ativa","tem_contato":true}'

{
  "data": [
    {
      "cnpj": "12345678000190",
      "razao_social": "CLINICA SAUDE LTDA",
      "situacao": "Ativa",
      "contato": { "telefone": "(11) 3000-0000", "email": "contato@clinica.com.br" },
      "endereco": { "municipio": "SAO PAULO", "uf": "SP" },
      "cnae_principal": { "codigo": "8630501", "descricao": "Atividade médica ambulatorial" }
    }
  ],
  "count": 20,
  "page": 1,
  "quota": { "used": 3, "remaining": 47 }
}

{
  "used":      3,
  "limit":     50,
  "remaining": 47,
  "reset_at":  "2026-05-26T00:00:00.000Z"
}

{
  "history": [
    {
      "filters": { "cnae": "8630501", "uf": "SP" },
      "result_count": 20,
      "created_at": "2026-05-25T22:00:00Z"
    }
  ]
}

curl -X POST "https://api.cnpjob.com.br/api/portal/analysis/request" \
  -H "Authorization: Bearer SEU_JWT" \
  -H "Content-Type: application/json" \
  -d '{"cnae_codigo":"8630501","municipio_codigo":"3550308","descricao_negocio":"Clínica de fisioterapia especializada em idosos"}'

{
  "jobId":             "uuid-do-acesso",
  "status":            "done",
  "report": {
    "score_viabilidade": 72,
    "classificacao":    "Moderada",
    "resumo_executivo": "...",
    "analise_concorrencia": { "total_municipio": 847, "tendencia": "Crescendo" },
    "faixa_preco": { "minimo_estimado": 80, "media_estimada": 145, "maximo_estimado": 380 },
    "pontos_atencao": ["..."],
    "recomendacoes":  ["..."]
  },
  "score_viabilidade": 72,
  "last_updated_at":   "2026-05-25T22:00:00Z"
}

{
  "jobId":           "uuid-do-acesso",
  "status":          "refreshing",
  "report": { /* relatório anterior, ainda válido */ },
  "score_viabilidade": 72,
  "last_updated_at":  "2026-05-10T00:00:00Z"
}

{
  "jobId":  "uuid-do-acesso",
  "status": "processing"
}

async function waitForAnalysis(jobId, token) {
  while (true) {
    const res  = await fetch(`/api/portal/analysis/${jobId}`, {
      headers: { Authorization: `Bearer ${token}` }
    });
    const data = await res.json();
    if (data.status === 'done')    return data.report;
    if (data.status === 'failed') throw new Error('Análise falhou');
    await new Promise(r => setTimeout(r, 4000));
  }
}

{
  "status":            "done",
  "report": { /* objeto completo do relatório */ },
  "score_viabilidade": 72,
  "last_updated_at":   "2026-05-25T22:00:00Z",
  "cnae_codigo":       "8630501",
  "municipio_codigo":  "3550308",
  "cnae_descricao":    "Atividade médica ambulatorial",
  "municipio_nome":    "SAO PAULO"
}

{
  "used":      2,
  "limit":     5,
  "remaining": 3,
  "reset_at":  "2026-06-01T00:00:00.000Z"
}

curl "https://api.cnpjob.com.br/api/portal/analysis/nearby-places?cnae_descricao=Fisioterapia&municipio_nome=SAO+PAULO" \
  -H "Authorization: Bearer SEU_JWT"

{
  "available": true,
  "places": [
    {
      "name":          "Clínica Fisio Centro",
      "address":       "Rua das Flores, 100 - Centro, São Paulo",
      "rating":        4.7,
      "total_ratings": 128,
      "maps_url":      "https://www.google.com/maps/place/?q=place_id:..."
    }
  ]
}