身份与验证

制裁名单筛查 API

在客户开通时和付款之前筛查客户、供应商和交易对手。一次请求即可搜索五份官方制裁名单，并返回每个潜在匹配的名单条目、制裁项目、国家、出生日期和匹配分数。

API 端点活跃

POST /v1/sanctions/screen

请求示例

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Banco Nacional de Cuba"}' \
  "https://domscan.net/v1/sanctions/screen"

响应示例 200 OK

{
  "status": "potential_match",
  "matches": [
    {
      "list": "ofac_sdn",
      "entry_id": "306",
      "name_score": 1,
      "match_type": "exact",
      "matched_name": "BANCO NACIONAL DE CUBA",
      "entity_type": "organization",
      "programs": ["CUBA"],
      "aliases": ["BNC", "NATIONAL BANK OF CUBA"],
      "signals": { "date_of_birth": "no
...

请求示例 POST /v1/sanctions/screen

主要功能 4

常见问题解答 4

HTTP 状态码 200 / 400 / 401 / 402 / 409 / 422 / 429

分类 身份与验证

API 端点 1

主要功能 4

常见问题解答 4

被这些公司的人员使用

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

实时服务状态

集成前，请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始，只有在用量增长时再升级。

这个 API 可以帮你交付什么

把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。

产品工作流

把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。

分析自动化

用计划任务、告警和可复现的调查步骤替代重复的人工查询。

干净的 JSON 数据

使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。

AI 和运维工具

通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。

集成流程

从第一次请求到可重复生产使用的简单路径。

一次认证

使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。

用示例查询

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

运行和监控

使用状态码、积分成本和响应字段构建重试、日志和告警。

开发者工具包

从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。

OpenAPI 架构

生成客户端，或检查每种请求和响应结构。

Postman 集合

导入现成请求，用于手动测试和团队交接。

SDK 和 CLI

使用维护中的包和命令行流程，避免编写样板代码。

MCP 集成

把域名情报暴露给 AI 代理和内部助手工作流。

参数和响应映射

在把端点接入客户端前，快速查看输入、输出字段和状态码。

请求参数

参数

nametypecountrydate_of_birthliststhresholdlimit

响应字段

响应示例

statusmatchestotal_matcheslists

状态覆盖

HTTP 状态码

200400401402409422429

API 端点

POST /v1/sanctions/screen

积分: 2身份验证: 需要身份验证

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

实时服务状态

集成前，请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始，只有在用量增长时再升级。

主要功能

五份官方名单，每日刷新

美国 OFAC SDN 名单和综合名单（非 SDN）、UN 安全理事会名单、EU 金融制裁名单以及 UK 制裁名单，每条结果都附有各名单的发布日期。

专为姓名设计的模糊匹配

支持语序、重音符号、音译、别名、首字母缩写、拼写错误和发音相近的拼写，以及原始西里尔字母和阿拉伯文字的名称。

绝不隐藏匹配的信号

出生日期和国家用于对匹配结果排序，并报告为相符或不符，但阈值仅适用于姓名本身。

不给出虚假的“无风险”

只有当所有名单都在最近 72 小时内得到确认时，才会返回 no_match。否则结果为未知，且不收费。

请求示例

POST /v1/sanctions/screen bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Banco Nacional de Cuba"}' \
  "https://domscan.net/v1/sanctions/screen"

响应示例

200 OK json

{
  "status": "potential_match",
  "matches": [
    {
      "list": "ofac_sdn",
      "entry_id": "306",
      "name_score": 1,
      "match_type": "exact",
      "matched_name": "BANCO NACIONAL DE CUBA",
      "entity_type": "organization",
      "programs": ["CUBA"],
      "aliases": ["BNC", "NATIONAL BANK OF CUBA"],
      "signals": { "date_of_birth": "not_provided", "country": "not_provided" }
    }
  ],
  "total_matches": 1,
  "lists": [
    { "id": "ofac_sdn", "status": "checked", "entries": 19457, "published_at": "2026-10-16" },
    { "id": "un", "status": "checked", "entries": 1010 },
    { "id": "eu", "status": "checked", "entries": 6234 },
    { "id": "uk", "status": "checked", "entries": 6408 }
  ]
}

常见问题解答

潜在匹配是最终认定吗？

不是。它只是需要人工对照名单条目复核的线索。DomScan 不会判定某个人或企业是否就是被制裁方。

是否涵盖政治公众人物 (PEP)？

不涵盖。该 API 仅筛查官方制裁名单，不包含 PEP、负面新闻或其他来源的观察名单。

被筛查的名称会被存储吗？

筛查请求不会保留在您的请求日志中，只会保留用量和计费记录。

每次调用消耗多少额度？

每个名称消耗两个额度。因名单过期或不可用而结果为未知的请求不收费。

HTTP 状态码

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

成功 200

请求成功

请求错误 400

参数无效

未授权 401

API 密钥或会话缺失或无效。

需要付款 402

没有足够额度来执行此请求。

HTTP 409 409

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

HTTP 422 422

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

请求过多 429

超出速率限制

筛查名称

免费开始查看文档试用免费工具

客户支持

制裁名单筛查 API

集成前可见的信任信号

这个 API 可以帮你交付什么

集成流程

开发者工具包

参数和响应映射

API 端点

集成前可见的信任信号

主要功能

请求示例

响应示例

常见问题解答

相关工具和资源

HTTP 状态码