Säkerhet och tillit · DomScan-produkt

E-postsvartlista API-referens

Kontrollera om en domän eller IP är listad på e-post svartlistor.

Det här får du

Kontrollera om en domän eller IP är listad på e-post svartlistor.

SynkrontBulkRESTMCPSDKInteraktivt verktyg

Välj denna produkt när

Vem är det till för?

Använd avgränsade passiva kontroller för att berika triage och utredning, inte för att ersätta auktoriserad testning eller mänsklig granskning.

Välj denna produkt när

Välj detta för att kontrollera stödda svartlistebevis vid en viss tidpunkt. Ett rent resultat är ingen universell ryktesgaranti.

Det här får du

Kontrollera om en domän eller IP är listad på e-post svartlistor.

Endpoints

Se vad varje endpoint accepterar och returnerar, dess lägen och begränsningar innan du integrerar.

GET /v1/email/check Visa API-referens
POST /v1/email/check/bulk Visa API-referens
GET /v1/email/blacklist Visa API-referens
GET /v1/email/blacklist/download Visa API-referens

Credits och autentisering

0-1 Autentisering krävs. Se API-referensen för den exakta kostnaden, inklusive eventuell prissättning per post.

Exempel på operation

Använd dokumenterade operationer för att samla in, bedöma, berika, verifiera, jämföra, skydda eller övervaka offentliga bevis.

GET /v1/email/check Krediter: 1

Frågeparametrar

Parameter Typ obligatorisk
email string obligatorisk
checks string valfri

Svarsfält

Fält Typ
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

Exempelbegäran

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))

Exempelsvar

{
  "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"
}

HTTP-statuskoder

  • 200 OK
  • 400 Felaktig begäran
  • 401 Obehörig
  • 402 Betalning krävs
  • 429 För många begäranden

Vanliga frågor

Var hittar jag request- och response-referensen för E-postsvartlista?

Använd API-referensen för E-postsvartlista för att granska parametrar, svarsfält, exempel, statuskoder och stödda körningslägen.

Hur ska jag tolka okända eller ofullständiga resultat från E-postsvartlista?

Okänt eller delvis betyder att vi inte kunde bekräfta resultatet fullt ut. Ta hänsyn till status, säkerhet, aktualitet och eventuella begränsningar när du agerar på det.

Hur prissätts E-postsvartlista?

Priset beror på kontrollen och det läge du väljer. API-referensen visar den aktuella kreditkostnaden, om du behöver en API-nyckel och eventuell prissättning per post.

Används av människor på dessa företag

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse