API de Verificação
de Fraudes
Integre análise de links, telefones, domínios, e-mails, Pix, CNPJ e mensagens ao seu sistema com uma única chamada REST. Resultado em segundos.
7
Tipos de verificação
15+
Bases de segurança
< 2s
Tempo médio de resposta
Como começar
Em 3 passos você faz sua primeira verificação.
Gere uma API Key
No painel, acesse "API Keys" e clique em "+ Nova chave". Copie e guarde com segurança.
Ir para API Keys →Faça a primeira chamada
Envie um POST para /api/v1/verify com o header Authorization.
Ver exemplos →Endpoint de verificação
Verifica um item e retorna score, sinais e detalhes técnicos.
/api/v1/verifyHeaders
| Header | Tipo | Descrição |
|---|---|---|
| Authorization | obrigatório | Bearer vi_live_SUA_CHAVE |
| X-API-Key | alternativo | vi_live_SUA_CHAVE (substituto do Authorization) |
| Content-Type | obrigatório | application/json |
Body (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| input | string — obrigatório | O conteúdo a verificar (máx. 2000 chars) |
| type | string — opcional | "url" | "domain" | "phone" | "email" | "pix" | "message" — auto-detectado se omitido |
Campos da resposta
data.riskScoreNúmero de 0 a 100. Quanto maior, mais perigoso.
data.riskLevel"low" | "attention" | "suspicious" | "high"
data.summaryResumo da análise em português
data.recommendationsLista de ações recomendadas
data.signals[].nameNome descritivo do sinal detectado
data.signals[].impactContribuição do sinal no score final
data.detailsMetadados técnicos do item verificado (domínio, carrier, deliverability…)
data.shareUrlURL pública do resultado para compartilhar
data.fromCachetrue se o resultado veio do cache (< 1h)
meta.remainingTodayConsultas restantes no dia
/api/v1/batch— até 10 itens por chamadaVerificação em lote. Cada item consome 1 consulta do limite diário.
curl -X POST https://verificaisso.com.br/api/v1/batch \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"inputs": [
{ "input": "https://site-suspeito.com", "type": "url" },
{ "input": "(11) 99999-9999", "type": "phone" },
{ "input": "pagamento@empresa-falsa.com", "type": "pix" }
]
}'Tipos de verificação
O campo type é opcional — se omitido, a IA detecta automaticamente.
type: "url"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "https://bradesco-seguro-pix.xyz/login",
"type": "url"
}'type: "domain"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "banco-falso-pix.shop",
"type": "domain"
}'type: "phone"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "(11) 99123-4567",
"type": "phone"
}'type: "email"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "suporte@bradesco-seguro.com",
"type": "email"
}'type: "pix"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "pagamento@empresa-falsa.com",
"type": "pix"
}'type: "cnpj"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "11.222.333/0001-81",
"type": "cnpj"
}'type: "message"curl -X POST https://verificaisso.com.br/api/v1/verify \
-H "Authorization: Bearer vi_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"input": "Parabéns! Você foi selecionado. Clique para resgatar seu prêmio.",
"type": "message"
}'Resposta completa
Exemplo real de resposta para uma URL de alto risco.
{
"ok": true,
"data": {
"input": "https://bradesco-seguro-pix.xyz/login",
"type": "url",
"riskScore": 92,
"riskLevel": "high",
"summary": "Múltiplos indicadores de risco identificados.",
"recommendations": [
"Não clique em links e não forneça senhas.",
"Não realize pagamentos ou transferências Pix."
],
"signals": [
{
"name": "Listado como phishing pelo Google Safe Browsing",
"provider": "google-safe-browsing",
"category": "risk",
"description": "Listado como phishing pelo Google Safe Browsing",
"impact": 35,
"confidence": 95
},
{
"name": "Domínio registrado há 3 dias",
"provider": "rdap",
"category": "risk",
"description": "Domínio com registro muito recente",
"impact": 20,
"confidence": 95
}
],
"details": {
"domain": "bradesco-seguro-pix.xyz",
"ageInDays": 3,
"registrar": "Namecheap",
"hasSsl": true,
"httpStatus": 200,
"country": "US"
},
"shareUrl": "https://verificaisso.com.br/resultado/abc123",
"scanId": "550e8400-e29b-41d4-a716-446655440000",
"fromCache": false,
"reportCount": 7,
"scanCount": 42
},
"meta": {
"plan": "free",
"usedToday": 3,
"limitToday": 20,
"remainingToday": 17
}
}Códigos de erro
Erros retornam JSON: { "ok": false, "error": { "code": 401, "message": "..." } }
| Status | Quando ocorre |
|---|---|
| 400 | Body inválido, campo 'input' ausente/vazio ou tipo incompatível com o input |
| 401 | API key ausente, inválida ou revogada |
| 429 | Limite diário ou por minuto atingido |
| 500 | Erro interno — tente novamente em alguns segundos |
Limites de uso
Limites renovados diariamente à meia-noite (UTC). O campo meta.remainingToday na resposta informa o saldo restante.
| Plano | Consultas/dia | Consultas/min |
|---|---|---|
| Free | 20 | 10 |
| Starter | 500 | 60 |
| Pro | 5.000 | 200 |
| Enterprise | Personalizado | 1.000+ |
Casos de uso
Empresas que precisam proteger usuários contra fraudes digitais.
Bancos e fintechs
Verifique Pix, telefones e URLs antes de aprovar transferências ou exibir mensagens ao usuário.
Marketplaces
Detecte anúncios fraudulentos e vendedores suspeitos antes da publicação.
Apps de mensagens
Alerte usuários sobre links perigosos recebidos em chats antes do clique.
Pronto para integrar?
Crie sua conta gratuitamente, gere uma API key no painel e faça sua primeira verificação em minutos.