Segurança e confiança · Produto DomScan

API de Lista Negra de Email

Verifique se um domínio ou IP está listado em listas negras de email.

O que você recebe

Verifique se um domínio ou IP está listado em listas negras de email.

SíncronoEm loteRESTMCPSDKFerramenta interativa

Escolha este produto quando

Para quem é

Use verificações passivas limitadas para enriquecer triagem e investigação, não para substituir testes autorizados ou análise humana.

Escolha este produto quando

Escolha para verificar evidências compatíveis de listas de bloqueio em um momento. Um resultado limpo não garante reputação universal.

O que você recebe

Verifique se um domínio ou IP está listado em listas negras de email.

Endpoints

Veja o que cada endpoint aceita e retorna, seus modos e seus limites antes de integrar.

GET /v1/email/check Ver referência da API
POST /v1/email/check/bulk Ver referência da API
GET /v1/email/blacklist Ver referência da API
GET /v1/email/blacklist/download Ver referência da API

Créditos e autenticação

0-1 Autenticação obrigatória. Consulte a referência da API para ver o custo exato, incluindo eventuais preços por item.

Operação de exemplo

Use operações documentadas para coletar, avaliar, enriquecer, verificar, comparar, proteger ou monitorar evidências públicas.

GET /v1/email/check Créditos: 1

Parâmetros de consulta

Parâmetro Tipo obrigatório
email string obrigatório
checks string opcional

Campos da resposta

Campo Tipo
email string
domain string
local_part string
valid_syntax boolean
checks object
checks.disposable object
checks.disposable.is_disposable boolean
checks.disposable.confidence string | null
checks.disposable.matched_pattern string
checks.role object
checks.role.is_role boolean
checks.role.role_type string | null
checks.free object
checks.free.is_free boolean
checks.free.provider string | null
checks.mx object
checks.mx.has_mx boolean | null
checks.mx.records[] string[]
checks.mx.null_mx boolean
checks.dnsbl object
checks.dnsbl.domain string
checks.dnsbl.ip string
checks.dnsbl.listed boolean
checks.dnsbl.lists[] object[]
checks.dnsbl.lists[] object
checks.dnsbl.lists[].name string
checks.dnsbl.lists[].listed boolean
checks.dnsbl.lists[].status string
checks.dnsbl.lists[].code string
checks.dnsbl.lists[].meaning string
checks.dnsbl.lists[].unknown_reason string
checks.dnsbl.lists_unknown integer
checks.dnsbl.threat_level string
checks.dnsbl.check_type string
checks.dnsbl.checked_at string
risk_score integer
risk_level string
flags[] string[]
checked_at string

Exemplo de requisição

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl"
const response = await fetch("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/email/check?email=user%40example.com&checks=disposable%2Crole%2Cfree%2Cmx%2Cdnsbl")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Exemplo de resposta

{
  "email": "[email protected]",
  "domain": "acme-widgets.com",
  "local_part": "support",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": false,
      "confidence": null
    },
    "role": {
      "is_role": true,
      "role_type": "support"
    },
    "free": {
      "is_free": false,
      "provider": null
    },
    "mx": {
      "has_mx": true,
      "records": [
        "mx1.mailhost-example.net",
        "mx2.mailhost-example.net"
      ]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 20,
  "risk_level": "low",
  "flags": [
    "ROLE_ADDRESS"
  ],
  "checked_at": "2026-10-09T10:15:30.000Z"
}

Códigos de status HTTP

  • 200 OK
  • 400 Pedido inválido
  • 401 Não autorizado
  • 402 Pagamento necessário
  • 429 Demasiados pedidos

Perguntas frequentes

Onde encontro a referência de solicitação e resposta de Lista Negra de Email?

Use a referência da API de Lista Negra de Email para revisar parâmetros, campos de resposta, exemplos, códigos de status e modos de operação compatíveis.

Como devo interpretar resultados desconhecidos ou incompletos de Lista Negra de Email?

Desconhecido ou parcial significa que não conseguimos confirmar totalmente o resultado. Considere o status, a confiança, a atualidade e quaisquer limites antes de agir.

Como Lista Negra de Email é cobrado?

O preço depende da verificação e do modo escolhido. A referência da API mostra o custo atual em créditos, se você precisa de uma chave de API e eventuais preços por item.

Usado por pessoas nestas empresas

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse