이메일 블랙리스트 API 레퍼런스

작업

GET /v1/email/check API 레퍼런스 보기

POST /v1/email/check/bulk API 레퍼런스 보기

GET /v1/email/blacklist API 레퍼런스 보기

GET /v1/email/blacklist/download API 레퍼런스 보기

GET `/v1/email/check`

작업: checkEmailBlacklist 크레딧 및 인증: 1 인증 필요

GET /v1/email/check

쿼리 매개변수

매개변수	유형	필수
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.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
`checks.mx.records[]`	string[]
`checks.dnsbl`	object
`checks.dnsbl.listed`	boolean
`checks.dnsbl.threat_level`	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"

예제 응답

{
  "email": "[email protected]",
  "domain": "tempmail.org",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": true,
      "confidence": "high"
    },
    "role": {
      "is_role": false,
      "role_type": "string"
    },
    "free": {
      "is_free": false,
      "provider": "string"
    },
    "mx": {
      "has_mx": true,
      "records": [
        "mx1.tempmail.org"
      ]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": [
    "DISPOSABLE_DOMAIN"
  ],
  "checked_at": "2026-04-15T12:00:00Z"
}

POST `/v1/email/check/bulk`

작업: bulkEmailCheck 크레딧 및 인증: 1 인증 필요

POST /v1/email/check/bulk

본문 매개변수

매개변수	유형	필수
emails	string[]	필수
checks	string[] 허용된 값 `disposablerolefreemxdnsbl`	선택 사항

응답 필드

필드	유형
`results[]`	object[]
`results[]`	object
`summary`	object
`summary.total`	integer
`summary.disposable`	integer
`summary.role_based`	integer
`summary.free_provider`	integer
`summary.no_mx`	integer
`summary.dnsbl_listed`	integer
`summary.high_risk`	integer
`summary.medium_risk`	integer
`summary.low_risk`	integer
`checked_at`	string

예제 요청

curl -X POST "https://domscan.net/v1/email/check/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "emails": [
    "[email protected]",
    "[email protected]"
  ],
  "checks": [
    "disposable",
    "role",
    "free"
  ]
}'

예제 응답

{
  "results": [
    {}
  ],
  "summary": {
    "total": 10,
    "disposable": 3,
    "role_based": 1,
    "free_provider": 2,
    "no_mx": 0,
    "dnsbl_listed": 0,
    "high_risk": 3,
    "medium_risk": 1,
    "low_risk": 6
  },
  "checked_at": "2026-04-15T12:00:00Z"
}

GET `/v1/email/blacklist`

작업: getEmailBlacklistInfo 크레딧 및 인증: 무료 인증 필요

GET /v1/email/blacklist

쿼리 매개변수

매개변수	유형	필수
limit	integer 기본값 `1000`	선택 사항
offset	integer 기본값 `0`	선택 사항
format	string 허용된 값 `jsontxt` 기본값 `json`	선택 사항

응답 필드

필드	유형
`domains[]`	string[]
`total`	integer
`offset`	integer
`limit`	integer
`metadata`	object
`metadata.last_updated`	string
`metadata.total_domains`	integer
`metadata.high_confidence_count`	integer
`metadata.wildcard_count`	integer
`metadata.sources[]`	string[]
`metadata.source_count`	integer
`metadata.successful_source_count`	integer
`metadata.failed_source_count`	integer
`metadata.refresh_cadence_hours`	integer
`metadata.refresh_status`	string
`metadata.next_refresh_due`	string
`metadata.dataset_status`	string
`metadata.quality_policy_version`	integer \| null
`metadata.quarantined_domain_count`	integer
`metadata.rejected_domain_count`	integer

예제 요청

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist?limit=25&offset=0&format=example.com"

예제 응답

{
  "domains": [
    "10minutemail.com",
    "guerrillamail.com"
  ],
  "total": 198362,
  "offset": 0,
  "limit": 1000,
  "metadata": {
    "last_updated": "2026-04-15T12:00:00Z",
    "total_domains": "example.com",
    "high_confidence_count": 1,
    "wildcard_count": 1,
    "sources": [
      "string"
    ],
    "source_count": 1,
    "successful_source_count": 1,
    "failed_source_count": 1,
    "refresh_cadence_hours": 24,
    "refresh_status": "fresh",
    "next_refresh_due": "2026-04-15T12:00:00Z",
    "dataset_status": "complete",
    "quality_policy_version": 1,
    "quarantined_domain_count": "example.com",
    "rejected_domain_count": "example.com"
  }
}

GET `/v1/email/blacklist/download`

작업: downloadEmailBlacklist 크레딧 및 인증: 무료 인증 필요

GET /v1/email/blacklist/download

쿼리 매개변수

매개변수	유형	필수
format	string 허용된 값 `jsontxt` 기본값 `json`	선택 사항

응답 필드

필드	유형
`domains[]`	string[]
`wildcards[]`	string[]
`metadata`	object

예제 요청

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist/download?format=example.com"

예제 응답

{
  "domains": [
    "example.com"
  ],
  "wildcards": [
    "string"
  ],
  "metadata": {}
}

레퍼런스 리소스

OpenAPI 3.0 Postman MCP