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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
base64File | string | Obrigatório | Conteú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
| Campo | Tipo | Descrição |
|---|---|---|
status | string | Status da operação (success/error). |
dados.chaveAcesso | string | Chave de acesso da NFe (44 dígitos). |
dados.emitente.cnpj | string | CNPJ da empresa emissora. |
dados.itens | array | Lista 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
imagem_frente | string | Obrigatório | URL ou base64 do documento aberto, ou apenas da parte frontal. |
imagem_verso | string | Opcional | URL 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
| Campo | Tipo | Descrição |
|---|---|---|
tipo_documento | string | Tipo de documento identificado (CNH ou RG). |
nome_completo | string | Nome completo do titular. |
cpf | string | CPF extraído do documento. |
data_validade | string | Data 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
dados_crus | string | Obrigatório | Especificações técnicas ou nome simples. Ex: iPhone 13 128GB Preto |
foto_base64 | string | Opcional | Foto 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
| Campo | Tipo | Descrição |
|---|---|---|
titulo_seo | string | Título otimizado com palavras-chave relevantes. |
descricao_curta | string | Meta description otimizada para o Google. |
copy_vendas | string | Texto persuasivo para a página do produto. |
tags | array | Lista 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo insuficiente. |
Análise de Sentimento e Roteamento (SAC)
Classifique tickets de suporte por urgência e sentimento para otimizar o atendimento ao cliente.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
texto_ticket | string | Obrigatório | O 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo insuficiente. |
NLP e Triagem para WhatsApp
Transforme áudios e mensagens informais do WhatsApp em dados estruturados e intenções claras.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
texto_mensagem | string | Opcional | Mensagem de texto enviada pelo usuário. |
audio_base64 | string | Opcional | Arquivo 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo insuficiente. |
Auditoria e Extração de Contratos
Extraia cláusulas, partes, valores e prazos de contratos jurídicos complexos automaticamente.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
pdf_base64 | string | Obrigatório | Arquivo 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
descricao_vaga | string | Obrigatório | Texto com os requisitos e responsabilidades da vaga. |
pdf_base64 | string | Obrigatório | Arquivo 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
cnpj | string | Obrigatório | CNPJ 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
| Campo | Tipo | Descrição |
|---|---|---|
score_risco | number | Score de 0.0 (seguro) a 1.0 (crítico). |
status_compliance | string | Status sugerido (APROVADO, ATENÇÃO, REPROVADO). |
analise_detalhada | string | Parecer técnico gerado pela IA. |
noticias_recentes | array | Links 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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o CNPJ enviado. |
| 401 | UNAUTHORIZED | Chave de API inválida. |
| 402 | PAYMENT_REQUIRED | Saldo 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
pdf_base64 | string | Obrigatório | Conteú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
| Campo | Tipo | Descrição |
|---|---|---|
objeto_da_licitacao | string | Descrição clara do que está sendo licitado. |
data_limite | string | Data e hora final para entrega das propostas. |
capital_minimo_exigido | string | Valor de capital social mínimo exigido (ou null). |
resumo_executivo | string | Um resumo conciso dos pontos principais. |
riscos_de_desclassificacao | array | Lista de exigências difíceis ou cláusulas de risco. |
exigencias_tecnicas | array | Lista 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
cnpj | string | Obrigatório | CNPJ da empresa lead (apenas números ou formatado). |
produto_oferecido | string | Obrigatório | Descriçã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
| Campo | Tipo | Descrição |
|---|---|---|
score_de_venda | number | Pontuação de 0 a 100 baseada no fit comercial. |
perfil_ideal | boolean | True se a empresa se encaixa no perfil ideal de cliente. |
tamanho_estimado_empresa | string | Classificação baseada no capital social e CNAE. |
argumentos_de_venda_sugeridos | array | 3 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
nome_marca | string | Obrigatório | O 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
| Campo | Tipo | Descrição |
|---|---|---|
sentimento_geral | string | POSITIVO, NEUTRO ou NEGATIVO. |
tendencia_de_imagem | string | Descrição textual da percepção atual da marca. |
crises_recentes | array | Lista de fatos negativos ou polêmicas encontradas. |
fatos_positivos | array | Lista 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
ticker_ativo | string | Obrigatório | O código do ativo (ex: PETR4, BTC, VALE3). |
tipo | string | Opcional | Tipo 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
| Campo | Tipo | Descrição |
|---|---|---|
ativo_analisado | string | O ticker ou nome do ativo confirmado. |
sentimento_mercado | string | BULLISH, BEARISH ou NEUTRO. |
impacto_curto_prazo | string | Análise do impacto imediato no preço. |
noticias_motivadoras | array | Lista de notícias que sustentam o sentimento. |
riscos_macroeconomicos | array | Fatores 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
cnpj | string | Obrigatório | O 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.
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.
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
file | file | Obrigatório | Arquivo 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
historico_conversa | string | Obrigatório | Texto 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.
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
| Campo | Tipo | Status | Descrição |
|---|---|---|---|
valor | number | Obrigatório | Valor do boleto em reais. |
pagador | object | Obrigatório | Dados 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.
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.
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.
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).
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
| Status | Código | O que fazer |
|---|---|---|
| 400 | BAD_REQUEST | Verifique o corpo da requisição e campos obrigatórios. |
| 401 | UNAUTHORIZED | Chave de API inválida ou expirada. |
| 402 | PAYMENT_REQUIRED | Saldo insuficiente. |