Bem-vindo ao NODIA v1.0.8

Nossa missão é fornecer a inteligência artificial mais avançada em endpoints simples, limpos e feitos para desenvolvedores brasileiros. Um único endpoint, dezenas de soluções.

Autenticação

Todas as requisições para as APIs do NODIA requerem autenticação via Header HTTP. Você deve passar a sua chave secreta no header x-api-key.

x-api-key: sk_live_sua_chave_aqui_12345

Mantenha sua chave segura e nunca a exponha em código client-side (como navegadores ou aplicativos móveis). Gere suas chaves no Painel do Desenvolvedor.


OCR de Documentos Fiscais (NFe e NFS-e)

Extraia dados estruturados de Notas Fiscais de Produto (NF-e) e de Serviço (NFS-e) automaticamente via OCR com Inteligência Artificial.

POST https://api.nodia.api.br/api/extractDocument

Visão Geral

A API de OCR para Notas Fiscais do NODIA elimina a digitação manual em sistemas de ERP e contabilidade. Ela interpreta o layout de qualquer prefeitura ou estado, extraindo dados complexos como base de cálculo de ICMS, ISS, retenções e lista completa de produtos sem necessidade de templates fixos.

Casos de Uso

  • Automação Fiscal: Entrada automática de notas no ERP.
  • Gestão de Despesas: Reembolso automático de funcionários a partir de fotos de recibos.
  • Logística: Conferência rápida de mercadorias recebidas versus nota fiscal.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
base64FilestringObrigatórioConteúdo do arquivo (PDF ou Imagem) codificado em Base64.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/extractDocument"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"base64File": "JVBERi0xLjQK..."}'

Estrutura de Resposta

CampoTipoDescrição
statusstringStatus da operação (success/error).
dados.chaveAcessostringChave de acesso da NFe (44 dígitos).
dados.emitente.cnpjstringCNPJ da empresa emissora.
dados.itensarrayLista de produtos ou serviços extraídos.

Exemplo de Resposta

{
  "status": "success",
  "dados": {
    "numero": "000209",
    "chaveAcesso": "35230112345678000190550010000012341234567890",
    "emitente": { "nome": "EMPRESA EXEMPLO LTDA", "cnpj": "00.000.000/0000-00" },
    "itens": [ { "descricao": "Notebook Dell", "valorTotal": 4500.00 } ]
  }
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

OCR de Identidade (KYC - CNH e RG)

Extrai dados estruturados de documentos de identidade brasileiros (CNH e RG) a partir de imagens para validação de identidade.

POST https://api.nodia.api.br/api/v1/leitura-kyc

Visão Geral

A API de KYC automatiza a validação de identidade processando fotos de documentos. Ela extrai campos textuais vitais e identifica o tipo de documento, garantindo um onboarding mais rápido, seguro e com menos fricção para o usuário final.

Casos de Uso

  • Onboarding Digital: Cadastro rápido e sem digitação manual de usuários em Fintechs.
  • Locação de Veículos: Validação instantânea de dados do condutor e categoria da habilitação.
  • Segurança: Verificação rápida de identidade em portarias e catracas virtuais.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
imagem_frentestringObrigatórioURL ou base64 do documento aberto, ou apenas da parte frontal.
imagem_versostringOpcionalURL ou base64 da parte traseira do documento.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/leitura-kyc"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"imagem_frente": "https://meusite.com/cnh_frente.jpg"}'

Estrutura de Resposta

CampoTipoDescrição
tipo_documentostringTipo de documento identificado (CNH ou RG).
nome_completostringNome completo do titular.
cpfstringCPF extraído do documento.
data_validadestringData de validade (DD/MM/AAAA).

Exemplo de Resposta

{
  "tipo_documento": "CNH",
  "nome_completo": "JOÃO DA SILVA SAURO",
  "cpf": "123.456.789-01",
  "data_nascimento": "01/01/1980",
  "data_validade": "15/05/2030",
  "categoria_cnh": "AB"
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

SEO E-commerce (Enriquecimento de Produto)

Gera títulos otimizados, descrições persuasivas e tags para SEO a partir de fotos ou especificações técnicas de produtos.

POST https://api.nodia.api.br/api/v1/enriquecimento-produto

Visão Geral

A API de SEO para E-commerce utiliza IA generativa para transformar dados brutos de produtos em conteúdo de alta conversão. Ela analisa atributos técnicos e imagens para criar textos que ranqueiam melhor no Google e convencem o cliente final.

Casos de Uso

  • Marketplaces: Padronização de anúncios de múltiplos vendedores.
  • Novos Lançamentos: Criação rápida de páginas de produto a partir de fotos de protótipos.
  • Otimização de Catálogo: Melhoria em massa de descrições antigas para SEO.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
dados_crusstringObrigatórioEspecificações técnicas ou nome simples.
Ex: iPhone 13 128GB Preto
foto_base64stringOpcionalFoto do produto para análise visual e extração de atributos.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/enriquecimento-produto"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"dados_crus": "Camiseta Algodão Egípcio"}'

Estrutura de Resposta

CampoTipoDescrição
titulo_seostringTítulo otimizado com palavras-chave relevantes.
descricao_curtastringMeta description otimizada para o Google.
copy_vendasstringTexto persuasivo para a página do produto.
tagsarrayLista de tags sugeridas para categorização.

Exemplo de Resposta

{
  "titulo_seo": "Camiseta de Algodão Egípcio Premium - Conforto e Durabilidade",
  "descricao_curta": "Descubra a suavidade incomparável da nossa camiseta de algodão egípcio.",
  "copy_vendas": "Sinta o luxo na pele com nossa camiseta exclusiva...",
  "tags": ["moda masculina", "algodão egípcio", "premium"]
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

Análise de Sentimento e Roteamento (SAC)

Classifique tickets de suporte por urgência e sentimento para otimizar o atendimento ao cliente.

POST https://api.nodia.api.br/api/v1/roteamento-sac

Visão Geral

A API de Análise de Sentimento para SAC permite que empresas priorizem o atendimento humano onde ele é mais crítico. Ela detecta sarcasmo, frustração e intenção de cancelamento (churn) em mensagens de texto, sugerindo a melhor ação para o atendente.

Casos de Uso

  • Priorização de Fila: Atenda primeiro os clientes mais insatisfeitos ou irritados.
  • Alerta de Churn: Identifique ameaças de cancelamento de plano em tempo real.
  • Auditoria de Qualidade: Avalie o tom de voz das interações em larga escala.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
texto_ticketstringObrigatórioO texto da mensagem ou ticket do cliente para análise.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/roteamento-sac"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"texto_ticket": "Estou há 3 horas esperando e ninguém me ajuda!"}'

Exemplo de Resposta

{
  "sentimento": "EXTREMAMENTE_IRRITADO",
  "urgencia": "ALTA",
  "categoria_problema": "SUPORTE_TECNICO",
  "resumo_analise": "Cliente frustrado com tempo de espera elevado.",
  "sugestao_resposta_curta": "Pedimos desculpas pela demora. Estamos priorizando seu caso agora."
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

NLP e Triagem para WhatsApp

Transforme áudios e mensagens informais do WhatsApp em dados estruturados e intenções claras.

POST https://api.nodia.api.br/api/v1/triagem-whatsapp

Visão Geral

A API de NLP para WhatsApp resolve o problema da comunicação informal. Ela lida com erros de digitação, gírias e áudios longos, entregando um resumo executivo e a intenção de compra ou suporte do usuário de forma limpa e estruturada.

Casos de Uso

  • Chatbots de Vendas: Qualificação automática de leads via áudio ou texto.
  • Transcrição de Voz: Transforme mensagens de voz em texto pesquisável no CRM.
  • Triagem Inteligente: Encaminhe o cliente para o departamento certo baseado no contexto da conversa.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
texto_mensagemstringOpcionalMensagem de texto enviada pelo usuário.
audio_base64stringOpcionalArquivo de áudio (ogg/mp3/wav) em base64.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/triagem-whatsapp"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"texto_mensagem": "Quero saber o preço do plano premium"}'

Exemplo de Resposta

{
  "transcricao_limpa": "Gostaria de obter informações sobre o valor do plano premium.",
  "resumo_topicos": "Dúvida sobre precificação do plano premium.",
  "intencao": "COMPRA",
  "urgencia": "MEDIA"
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

Auditoria e Extração de Contratos

Extraia cláusulas, partes, valores e prazos de contratos jurídicos complexos automaticamente.

POST https://api.nodia.api.br/api/v1/auditoria-contrato

Visão Geral

A API de Auditoria de Contratos atua como um primeiro filtro jurídico (Due Diligence). Ela lê PDFs extensos e localiza informações críticas que muitas vezes passam despercebidas, como índices de reajuste, multas moratórias e condições de rescisão abusivas.

Casos de Uso

  • Gestão de CLM: Alimentação automática de sistemas de gestão de contratos (Contract Lifecycle Management).
  • Revisão Jurídica: Identificação rápida de cláusulas fora do padrão da empresa.
  • Auditoria Imobiliária: Extração de dados de contratos de locação e compra e venda.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
pdf_base64stringObrigatórioArquivo do contrato em PDF codificado em Base64.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/auditoria-contrato"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"pdf_base64": "base64_data..."}'

Exemplo de Resposta

{
  "partes_envolvidas": [ { "nome": "EMPRESA A", "papel": "CONTRATANTE" } ],
  "valor_total": 50000.00,
  "moeda": "BRL",
  "prazos": { "data_inicio": "2026-01-01", "vigencia_meses": 12 },
  "clausulas_criticas": [ { "titulo": "Multa", "nivel_risco": "MEDIO" } ]
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

Parsing de Currículos e Match de Vagas (ATS)

Automatize a triagem de RH extraindo dados de currículos e calculando o score de compatibilidade com a vaga.

POST https://api.nodia.api.br/api/v1/analise-curriculo

Visão Geral

A API de ATS (Applicant Tracking System) do NODIA utiliza IA para ler currículos como um recrutador humano faria. Ela não apenas extrai dados de contato e experiência, mas entende a senioridade e a aderência técnica do candidato em relação aos requisitos da vaga.

Casos de Uso

  • Triagem de Alto Volume: Filtre milhares de currículos em segundos para encontrar os melhores talentos.
  • Ranking de Candidatos: Priorize os perfis mais aderentes à vaga baseando-se em habilidades reais.
  • Enriquecimento de Banco de Dados: Mantenha os dados dos candidatos sempre estruturados no seu sistema de RH.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
descricao_vagastringObrigatórioTexto com os requisitos e responsabilidades da vaga.
pdf_base64stringObrigatórioArquivo do currículo em PDF (Base64).

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/analise-curriculo"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"descricao_vaga": "Vaga de Desenvolvedor Sênior", "pdf_base64": "..."}'

Exemplo de Resposta

{
  "nome_candidato": "Ronaldo Conde Pinto",
  "score_compatibilidade": 0.85,
  "habilidades_encontradas": ["React", "Node.js", "TypeScript"],
  "anos_experiencia_total": 8,
  "parecer_resumido": "Candidato altamente qualificado com sólida experiência técnica."
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.

Análise de Risco e Compliance de Fornecedores (Premium)

Realize uma auditoria profunda de fornecedores em segundos. Combina dados da Receita Federal com busca em tempo real (Grounding) por notícias e processos.

POST https://api.nodia.api.br/api/v1/analise-risco-fornecedor

Visão Geral

A API Premium de Risco de Fornecedores do NODIA é a ferramenta definitiva para departamentos de compras e compliance. Ela não apenas consulta o CNPJ, mas utiliza Inteligência Artificial com acesso à internet para identificar notícias negativas, envolvimento em escândalos, processos judiciais recentes e saúde financeira percebida no mercado.

Casos de Uso

  • Homologação de Fornecedores: Validação automática de novos parceiros com score de risco.
  • Monitoramento de Terceiros: Verificação periódica de compliance para evitar riscos reputacionais.
  • Auditoria de Compras: Suporte à decisão em contratações de alto valor.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
cnpjstringObrigatórioCNPJ do fornecedor a ser analisado (com ou sem pontuação).

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/analise-risco-fornecedor"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"cnpj": "00.000.000/0001-91"}'

Estrutura de Resposta

CampoTipoDescrição
score_risconumberScore de 0.0 (seguro) a 1.0 (crítico).
status_compliancestringStatus sugerido (APROVADO, ATENÇÃO, REPROVADO).
analise_detalhadastringParecer técnico gerado pela IA.
noticias_recentesarrayLinks e títulos de notícias relevantes encontradas.

Exemplo de Resposta

{
  "cnpj": "00.000.000/0001-91",
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "score_risco": 0.15,
  "status_compliance": "APROVADO",
  "analise_detalhada": "Empresa com situação cadastral regular e histórico positivo no mercado...",
  "pontos_atencao": ["Baixo capital social para o volume de contratos"],
  "noticias_recentes": [
    { "titulo": "Empresa Exemplo expande operações no Nordeste", "url": "https://...", "fonte": "G1" }
  ]
}

Códigos de Erro

StatusCódigoO que fazer
400BAD_REQUESTVerifique o CNPJ enviado.
401UNAUTHORIZEDChave de API inválida.
402PAYMENT_REQUIREDSaldo insuficiente (Custo: R$ 0,80).

Análise de Resumo e Risco de Licitações

Extraia inteligência jurídica de editais públicos em segundos. Identifique riscos de desclassificação e exigências críticas.

POST https://api.nodia.api.br/api/v1/analise-licitacao

Visão Geral

Esta API foi desenhada para atuar como um escudo jurídico para empresas que participam de licitações. Ela lê editais complexos (PDF) e extrai não apenas o resumo, mas foca em encontrar cláusulas draconianas e pegadinhas técnicas que podem levar à desclassificação.

Casos de Uso

  • Legaltechs: Automatize a triagem de editais para seus clientes.
  • Departamentos Jurídicos: Ganhe agilidade na leitura de centenas de páginas de editais.
  • Consultorias de Licitação: Identifique rapidamente se um cliente tem chances reais de vencer antes de investir tempo.

Parâmetros de Entrada

CampoTipoStatusDescrição
pdf_base64stringObrigatórioConteúdo do arquivo PDF do edital codificado em Base64.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/analise-licitacao"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"pdf_base64": "JVBERi0xLjQK..."}'

Estrutura de Resposta

CampoTipoDescrição
objeto_da_licitacaostringDescrição clara do que está sendo licitado.
data_limitestringData e hora final para entrega das propostas.
capital_minimo_exigidostringValor de capital social mínimo exigido (ou null).
resumo_executivostringUm resumo conciso dos pontos principais.
riscos_de_desclassificacaoarrayLista de exigências difíceis ou cláusulas de risco.
exigencias_tecnicasarrayLista de atestados ou certificações técnicas exigidas.

Exemplo de Resposta

{
  "objeto_da_licitacao": "Aquisição de equipamentos de rede para o Datacenter Municipal.",
  "data_limite": "25/05/2026 às 10:00h",
  "capital_minimo_exigido": "R$ 500.000,00",
  "resumo_executivo": "Pregão eletrônico para renovação de switches e roteadores...",
  "riscos_de_desclassificacao": [
    "Exigência de certificação proprietária X que poucas empresas possuem",
    "Prazo de entrega de 5 dias úteis após empenho (extremamente curto)"
  ],
  "exigencias_tecnicas": [
    "Atestado de capacidade técnica em fornecimento de switches L3",
    "Certificação ISO 27001 da empresa proponente"
  ]
}

Qualificação de Leads B2B (Lead Scoring)

Enriqueça seu CRM com inteligência artificial. Analise a saúde financeira e o fit comercial de um lead em segundos usando apenas o CNPJ.

POST https://api.nodia.api.br/api/v1/qualificacao-lead

Visão Geral

Esta API cruza dados oficiais da Receita Federal (via BrasilAPI) com o produto ou serviço que sua empresa oferece. O motor de IA analisa o CNAE, capital social e tempo de mercado para determinar se a empresa é um bom alvo e sugere os melhores argumentos de venda.

Casos de Uso

  • Sistemas de CRM: Pontue leads automaticamente assim que entram no funil.
  • Equipes de SDR: Priorize abordagens em empresas com maior probabilidade de fechamento.
  • Marketing B2B: Segmente campanhas baseadas no perfil ideal de cliente (ICP).

Parâmetros de Entrada

CampoTipoStatusDescrição
cnpjstringObrigatórioCNPJ da empresa lead (apenas números ou formatado).
produto_oferecidostringObrigatórioDescrição do que você quer vender para esta empresa.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/qualificacao-lead"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{
    "cnpj": "00000000000191",
    "produto_oferecido": "Software de automação logística para grandes frotas"
  }'

Estrutura de Resposta

CampoTipoDescrição
score_de_vendanumberPontuação de 0 a 100 baseada no fit comercial.
perfil_idealbooleanTrue se a empresa se encaixa no perfil ideal de cliente.
tamanho_estimado_empresastringClassificação baseada no capital social e CNAE.
argumentos_de_venda_sugeridosarray3 argumentos personalizados para a abordagem comercial.

Exemplo de Resposta

{
  "score_de_venda": 85,
  "perfil_ideal": true,
  "tamanho_estimado_empresa": "Grande Porte",
  "argumentos_de_venda_sugeridos": [
    "Destaque como nossa automação reduz custos operacionais em frotas do tamanho da deles.",
    "Mencione a conformidade com as normas do CNAE de transporte de cargas pesadas.",
    "Foque na escalabilidade do sistema para acompanhar o capital social robusto da empresa."
  ]
}

Monitoramento de Sentimento de Marca (OSINT)

Analise a saúde da sua marca ou de concorrentes em tempo real usando IA conectada à busca oficial do Google.

POST https://api.nodia.api.br/api/v1/sentimento-marca

Visão Geral

Esta API utiliza o recurso de Google Search Grounding para realizar uma varredura em tempo real na web (notícias, blogs, portais de negócios) e identificar o sentimento geral em torno de uma marca, tendências de imagem e possíveis crises ou fatos positivos recentes.

Casos de Uso

  • PR & Branding: Monitore menções à sua marca e reaja rápido a crises.
  • Inteligência Competitiva: Analise o que o mercado está falando sobre seus concorrentes.
  • Due Diligence: Verifique a reputação de uma empresa antes de fechar parcerias.

Parâmetros de Entrada

CampoTipoStatusDescrição
nome_marcastringObrigatórioO nome da marca ou empresa a ser monitorada.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/sentimento-marca"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"nome_marca": "Nvidia"}'

Estrutura de Resposta

CampoTipoDescrição
sentimento_geralstringPOSITIVO, NEUTRO ou NEGATIVO.
tendencia_de_imagemstringDescrição textual da percepção atual da marca.
crises_recentesarrayLista de fatos negativos ou polêmicas encontradas.
fatos_positivosarrayLista de conquistas ou notícias positivas.

Exemplo de Resposta

{
  "sentimento_geral": "POSITIVO",
  "tendencia_de_imagem": "A marca é vista como líder em inovação tecnológica, especialmente no setor de IA.",
  "crises_recentes": [],
  "fatos_positivos": [
    "Lançamento de novos chips com performance recorde",
    "Aumento histórico no valor de mercado"
  ]
}

Radar de Ativos (Mercado Financeiro)

Monitore o sentimento do mercado financeiro em tempo real. Analise notícias recentes sobre ações e criptomoedas para prever tendências.

POST https://api.nodia.api.br/api/v1/radar-ativos

Visão Geral

A API de Radar de Ativos é uma ferramenta poderosa para traders e fintechs. Ela utiliza Google Search Grounding para ler notícias das últimas 24 horas sobre um ticker específico (ex: PETR4, BTC, AAPL) e devolve se o mercado está otimista (Bullish) ou pessimista (Bearish), acompanhado de fatos motivadores e riscos macroeconômicos.

Casos de Uso

  • Trading Algorítmico: Integre o sentimento do mercado em tempo real aos seus robôs de investimento.
  • Plataformas de Investimento: Ofereça insights automáticos e resumos de notícias para seus usuários.
  • Gestão de Portfólio: Monitore riscos macroeconômicos que podem afetar seus ativos em carteira.

Parâmetros de Entrada

CampoTipoStatusDescrição
ticker_ativostringObrigatórioO código do ativo (ex: PETR4, BTC, VALE3).
tipostringOpcionalTipo do ativo (ACAO, CRIPTO, COMMODITY).

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/radar-ativos"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{
    "ticker_ativo": "PETR4",
    "tipo": "ACAO"
  }'

Estrutura de Resposta

CampoTipoDescrição
ativo_analisadostringO ticker ou nome do ativo confirmado.
sentimento_mercadostringBULLISH, BEARISH ou NEUTRO.
impacto_curto_prazostringAnálise do impacto imediato no preço.
noticias_motivadorasarrayLista de notícias que sustentam o sentimento.
riscos_macroeconomicosarrayFatores externos que podem influenciar o ativo.

Exemplo de Resposta

{
  "ativo_analisado": "PETR4",
  "sentimento_mercado": "BULLISH",
  "impacto_curto_prazo": "Tendência de alta moderada devido aos preços do petróleo.",
  "noticias_motivadoras": [
    "Anúncio de novos dividendos acima do esperado",
    "Alta no preço do barril Brent no mercado internacional"
  ],
  "riscos_macroeconomicos": [
    "Incertezas sobre a política de preços interna",
    "Variação cambial do dólar"
  ]
}

Consulta CNPJ e Dados Cadastrais (RFB)

Consulte dados oficiais da Receita Federal em tempo real para validação de empresas e KYB.

POST https://api.nodia.api.br/api/v1/cnpj

Visão Geral

A API de Consulta CNPJ fornece acesso direto e estruturado aos dados públicos da Receita Federal. É a ferramenta essencial para processos de Know Your Business (KYB), validação de fornecedores e automação de cadastros B2B sem erros de digitação.

Casos de Uso

  • Automação de Cadastro: Preencha dados de faturamento e endereço automaticamente apenas com o CNPJ.
  • Compliance e KYB: Verificação de situação cadastral e quadro societário de parceiros comerciais.
  • Enriquecimento de CRM: Mantenha sua base de clientes B2B sempre atualizada com dados oficiais.

Autenticação

Header x-api-key obrigatório.

Parâmetros de Entrada

CampoTipoStatusDescrição
cnpjstringObrigatórioO número do CNPJ (com ou sem pontuação).

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/cnpj"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"cnpj": "00.000.000/0001-91"}'

Exemplo de Resposta

{
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "nome_fantasia": "EXEMPLO",
  "situacao_cadastral": "ATIVA",
  "data_abertura": "2010-05-20",
  "endereco": { "logradouro": "Rua das Flores", "numero": "123" }
}

Extração Financeira (DRE/Balanço)

Extraia KPIs financeiros de PDFs de DREs e Balanços Patrimoniais e obtenha um parecer automático de saúde financeira.

POST https://api.nodia.api.br/api/v1/analise-dre

Visão Geral

A API de Análise de DRE utiliza Visão Computacional e LLMs de longa janela de contexto para ler documentos financeiros complexos. Ela identifica automaticamente Receita, Lucro, EBITDA e outros indicadores, fornecendo um parecer de risco de crédito baseado nos dados extraídos.

Parâmetros de Entrada

Esta API utiliza multipart/form-data para o envio do arquivo.

CampoTipoStatusDescrição
filefileObrigatórioArquivo PDF contendo o Balanço ou DRE.

Exemplo de Requisição (cURL)

curl -X POST "https://api.nodia.api.br/api/v1/analise-dre"   -H "x-api-key: SUA_CHAVE_AQUI"   -F "file=@balanco_2023.pdf"

Exemplo de Requisição (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('balanco.pdf'));

axios.post('https://api.nodia.api.br/api/v1/analise-dre', form, {
  headers: {
    ...form.getHeaders(),
    'x-api-key': 'SUA_CHAVE_AQUI'
  }
}).then(res => console.log(res.data));

Estrutura de Resposta

{
  "receita_bruta": 1500000.00,
  "lucro_liquido": 250000.00,
  "margem_estimada": "16.6%",
  "saude_financeira_geral": "SAUDAVEL",
  "pontos_fortes": ["Crescimento constante de receita", "Baixo endividamento"],
  "sinais_de_alerta": ["Aumento nos custos fixos"]
}

Suitability (Perfil Investidor)

Classifique o perfil de risco de clientes (CVM) a partir de conversas naturais, eliminando formulários extensos.

POST https://api.nodia.api.br/api/v1/perfil-investidor

Visão Geral

A API de Suitability utiliza Processamento de Linguagem Natural (NLP) para analisar o histórico de conversas entre assessores e clientes. Ela identifica objetivos, tolerância a perdas e horizonte de investimento para classificar o perfil conforme as normas da CVM.

Parâmetros de Entrada

CampoTipoStatusDescrição
historico_conversastringObrigatórioTexto contendo a transcrição da conversa ou chat com o cliente.

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/perfil-investidor"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{"historico_conversa": "Cliente: Não gosto de perder dinheiro, prefiro segurança total."}'

Estrutura de Resposta

{
  "perfil_cvm": "CONSERVADOR",
  "tolerancia_a_risco": "Baixa tolerância a oscilações de curto prazo.",
  "produtos_sugeridos": ["Tesouro Selic", "CDB Pós-fixado", "Fundos DI"],
  "justificativa_classificacao": "O cliente prioriza preservação de capital e segurança sobre rentabilidade."
}

Registro de Boleto

Registra boletos bancários de forma estruturada diretamente nas instituições financeiras.

POST https://api.nodia.api.br/api/v1/boleto/registrar

Visão Geral

A API de Registro de Boleto permite a emissão de cobranças com registro imediato, garantindo a validade jurídica e a possibilidade de pagamento em qualquer canal bancário.

Parâmetros de Entrada

CampoTipoStatusDescrição
valornumberObrigatórioValor do boleto em reais.
pagadorobjectObrigatórioDados do pagador (nome, cpf_cnpj, endereco).

Exemplo de Requisição

curl -X POST "https://api.nodia.api.br/api/v1/boleto/registrar"   -H "Content-Type: application/json"   -H "x-api-key: SUA_CHAVE_AQUI"   -d '{
    "valor": 250,
    "pagador": {
      "nome": "João da Silva",
      "cpf_cnpj": "12345678909",
      "endereco": "Rua Exemplo, 123"
    }
  }'

Consulta CPF (Situação Cadastral)

Consulta a situação cadastral de um CPF diretamente na base da Receita Federal em tempo real.

POST https://api.nodia.api.br/api/v1/cpf/consulta

Visão Geral

Retorna o status do CPF na Receita Federal (REGULAR, SUSPENSA, CANCELADA, etc), nome completo e data de nascimento. Essencial para onboarding e e-commerce.

Custo

R$ 0,05 por consulta realizada com sucesso.


Validador de CPF (Grátis)

Validação lógica de dígitos verificadores de CPF.

GET https://api.nodia.api.br/api/v1/validar/cpf/{numero}

Visão Geral

Valida se um CPF é matematicamente válido utilizando o algoritmo de dígitos verificadores. Esta API é gratuita e não deduz do seu saldo.


Validador de CNPJ (Grátis - Numérico e Alfanumérico)

Validação lógica de CNPJ, compatível com o novo padrão alfanumérico da Receita Federal.

GET https://api.nodia.api.br/api/v1/validar/cnpj/{numero}

Visão Geral

Implementa o cálculo de DV conforme a nova normativa do SERPRO para CNPJs que utilizam letras e números (Alfanumérico). Grátis para uso ilimitado.


Cálculo DV Alfanumérico (Grátis)

Calcula apenas os dígitos verificadores para uma base de 12 caracteres (padrão Receita Federal).

POST https://api.nodia.api.br/api/v1/validar/cnpj/alpha-dv

Visão Geral

Recebe a base de 12 caracteres (ex: ABC123456789) e retorna os dois dígitos verificadores corretos conforme a Nota Técnica 01/2021.

Parâmetros de Entrada

{ "base": "ABC123456789" }

Códigos de Erro Gerais

StatusCódigoO que fazer
400BAD_REQUESTVerifique o corpo da requisição e campos obrigatórios.
401UNAUTHORIZEDChave de API inválida ou expirada.
402PAYMENT_REQUIREDSaldo insuficiente.