> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL. Source: https://domscan.net/zh/docs/products/sanctions-screening # 制裁名单筛查 API API 参考 对照国际制裁名单筛查个人或企业名称。 使用此参考选择操作，并集成其文档化的响应契约。 [查看产品页](https://domscan.net/zh/sanctions-screening-api) ## 操作 POST `/v1/sanctions/screen` [查看 API 参考](https://domscan.net/zh/docs/products/sanctions-screening#screenSanctions) ## POST `/v1/sanctions/screen` 操作: `screenSanctions` 积分和身份验证: 2 需要身份验证 POST /v1/sanctions/screen 积分: 2 #### 正文参数 | 参数 | 类型 | 必需 | | --- | --- | --- | | name | string | 必需 | | type | string 允许的值 `any`, `person`, `organization`, `vessel`, `aircraft` 默认值 `any` | 可选 | | country | string | 可选 | | date_of_birth | string | 可选 | | lists | string[] 允许的值 `ofac_sdn`, `ofac_consolidated`, `un`, `eu`, `uk` | 可选 | | threshold | number 默认值 `0.85` | 可选 | | limit | integer 默认值 `10` | 可选 | #### 响应字段 | 字段 | 类型 | | --- | --- | | `status` | string | | `reason` | string \| null | | `query` | object | | `query.name` | string | | `query.type` | string | | `query.country` | string \| null | | `query.date_of_birth` | string \| null | | `query.lists[]` | string[] | | `query.threshold` | number | | `query.limit` | integer | | `matches[]` | object[] | | `matches[]` | object | | `matches[].list` | string | | `matches[].entry_id` | string | | `matches[].score` | number | | `matches[].name_score` | number | | `matches[].match_type` | string | | `matches[].matched_name` | string | | `matches[].matched_name_kind` | string | | `matches[].alias_strength` | string \| null | | `matches[].entity_type` | string | | `matches[].primary_name` | string | | `matches[].aliases[]` | string[] | | `matches[].programs[]` | string[] | | `matches[].countries[]` | string[] | | `matches[].birth_dates[]` | object[] | | `matches[].birth_dates[]` | object | | `matches[].birth_dates[].date` | string \| null | | `matches[].birth_dates[].year` | integer \| null | | `matches[].birth_dates[].year_from` | integer \| null | | `matches[].birth_dates[].year_to` | integer \| null | | `matches[].birth_dates[].approximate` | boolean | | `matches[].birth_places[]` | string[] | | `matches[].listed_on` | string \| null | | `matches[].source_url` | string \| null | | `matches[].remarks` | string \| null | | `matches[].signals` | object | | `matches[].signals.date_of_birth` | string | | `matches[].signals.country` | string | | `total_matches` | integer | | `lists[]` | object[] | | `lists[]` | object | | `lists[].id` | string | | `lists[].name` | string | | `lists[].authority` | string | | `lists[].status` | string | | `lists[].entries` | integer \| null | | `lists[].published_at` | string \| null | | `lists[].fetched_at` | string \| null | | `lists[].source_url` | string | | `checked_at` | string | #### 请求示例 ```bash curl -X POST "https://domscan.net/v1/sanctions/screen" \ -H "Content-Type: application/json" \ -H "X-API-Key: $DOMSCAN_API_KEY" \ -d '{ "name": "Vladimir Putin", "type": "person", "country": "RU", "date_of_birth": "1952-10-07" }' ``` ```javascript const response = await fetch("https://domscan.net/v1/sanctions/screen", { method: "POST", headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" }, body: JSON.stringify({ "name": "Vladimir Putin", "type": "person", "country": "RU", "date_of_birth": "1952-10-07" }), }); const data = await response.json(); console.log(data); ``` ```python import os import requests response = requests.post( "https://domscan.net/v1/sanctions/screen", headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]}, json={ "name": "Vladimir Putin", "type": "person", "country": "RU", "date_of_birth": "1952-10-07", }, ) print(response.json()) ``` ```go package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { body := strings.NewReader(`{ "name": "Vladimir Putin", "type": "person", "country": "RU", "date_of_birth": "1952-10-07" }`) req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/sanctions/screen", body) if err != nil { panic(err) } req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY")) req.Header.Set("Content-Type", "application/json") 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)) } ``` ```ruby require "json" require "net/http" uri = URI("https://domscan.net/v1/sanctions/screen") request = Net::HTTP::Post.new(uri) request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY") request["Content-Type"] = "application/json" request.body = JSON.generate({ "name" => "Vladimir Putin", "type" => "person", "country" => "RU", "date_of_birth" => "1952-10-07" }) 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)) ``` #### 响应示例 ```json { "status": "potential_match", "reason": null, "query": { "name": "Vladimir Putin", "type": "person", "country": "RU", "date_of_birth": "1952-10-07", "lists": [ "ofac_sdn", "ofac_consolidated", "un", "eu", "uk" ], "threshold": 0.85, "limit": 10 }, "matches": [ { "list": "ofac_sdn", "entry_id": "35096", "score": 1, "name_score": 1, "match_type": "exact", "matched_name": "PUTIN, Vladimir Vladimirovich", "matched_name_kind": "primary", "alias_strength": null, "entity_type": "person", "primary_name": "PUTIN, Vladimir Vladimirovich", "aliases": [], "programs": [ "RUSSIA-EO14024" ], "countries": [ "RU" ], "birth_dates": [ { "date": "1952-10-07", "year": 1952, "year_from": null, "year_to": null, "approximate": false } ], "birth_places": [ "Leningrad, Russia" ], "listed_on": null, "source_url": null, "remarks": "President of the Russian Federation.", "signals": { "date_of_birth": "match", "country": "match" } } ], "total_matches": 1, "lists": [ { "id": "ofac_sdn", "name": "Specially Designated Nationals and Blocked Persons List", "authority": "US Treasury OFAC", "status": "checked", "entries": 19457, "published_at": "2026-10-16", "fetched_at": "2026-10-18T04:05:12.000Z", "source_url": "https://sanctionslistservice.ofac.treas.gov/api/publicationpreview/exports/sdn.csv" } ], "checked_at": "2026-10-18T04:20:00.000Z" } ``` #### HTTP 状态码 - `200` 成功 - `400` 请求错误 - `401` 未授权 - `402` 需要付款 - `409` HTTP 409 - `422` HTTP 422 - `429` 请求过多 ## 参考资源 [OpenAPI 3.0](https://domscan.net/v1/openapi.json) [Postman](https://domscan.net/v1/postman.json) [MCP](https://domscan.net/zh/mcp-domain-checker)