セキュリティと信頼性 · DomScan製品

メールブラックリスト APIリファレンス

ドメインまたは IP がメールブラックリストに登録されているかどうかをチェックします。

得られるもの

ドメインまたは IP がメールブラックリストに登録されているかどうかをチェックします。

同期一括RESTMCPSDKインタラクティブツール

この製品を選ぶ場面

対象ユーザー

権限のあるテストや人によるレビューの代わりではなく、範囲を限定した受動検査でトリアージと調査を補強します。

この製品を選ぶ場面

特定時点の対応ブラックリスト証拠を確認するときに選びます。クリーンな結果は普遍的な評判保証ではありません。

得られるもの

ドメインまたは IP がメールブラックリストに登録されているかどうかをチェックします。

エンドポイント

統合する前に、サポートされる操作、入力、出力、実行モード、レスポンス制限を確認してください。

GET /v1/email/check APIリファレンスを見る
POST /v1/email/check/bulk APIリファレンスを見る
GET /v1/email/blacklist APIリファレンスを見る
GET /v1/email/blacklist/download APIリファレンスを見る

クレジットと認証

0-1 認証が必要。正確な料金と項目ごとの料金については、操作リファレンスを確認してください。

操作例

文書化された操作を使って、公開証拠を収集、評価、補足、検証、比較、保護、監視します。

GET /v1/email/check クレジット: 1

クエリパラメータ

パラメータ タイプ 必須
email string 必須
checks string オプション

レスポンスフィールド

フィールド タイプ
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

リクエスト例

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

レスポンス例

{
  "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 ステータスコード

  • 200 成功
  • 400 不正なリクエスト
  • 401 未認証
  • 402 支払いが必要
  • 429 リクエスト過多

よくある質問

メールブラックリストのリクエストとレスポンスのリファレンスはどこで確認できますか?

メールブラックリストのAPIリファレンスで、パラメーター、レスポンスフィールド、例、ステータスコード、サポートされる操作モードを確認できます。

メールブラックリストの不明または不完全な結果はどのように解釈すべきですか?

不明または部分的な結果は、要求された証拠を完全には判定できなかったことを意味します。下流の判断では、結果の状態、信頼度、鮮度、制限を維持してください。

メールブラックリストの料金はどのように決まりますか?

料金は操作と実行モードによって異なります。現在のクレジット料金、認証要件、項目ごとのルールについては、エンドポイントリファレンスを確認してください。

これらの企業の担当者に使われています

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse