通过

OpenSanctions （独立发布者） （预览版）

OpenSanctions API 允许搜索和查询全球制裁和政治公开人员（PEP）数据库。 它为实体匹配、文本搜索、实体检索和精细语句级数据提供终结点。 使用它可检查人员或公司是否有制裁列表或浏览 OpenSanctions 实体图。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name OpenSanctions
URL https://developments.substack.com
Email dan.romano@swolcat.com
连接器元数据
发布者 krautrocker
网站 https://www.opensanctions.org/
隐私策略 https://www.opensanctions.org/docs/privacy/
类别 Data

OpenSanctions

概述

OpenSanctions API 提供对具有政治、刑事或经济利益的人员和企业的全球数据库的访问权限。 它聚合了数百个制裁名单、政治暴露者（PEP）和世界各地的观察名单中的数据。

可以使用此连接器匹配、搜索和提取实体、浏览关系和分析数据集覆盖范围。

在 OpenSanctions.org 了解详细信息。

Publisher - Dan Romano （swolcat）

先决条件

需要 OpenSanctions 中的 API 密钥才能使用此连接器。 在： https://www.opensanctions.org/api/

支持的作

按数据集匹配实体

根据姓名和可选字段（如出生日期、国籍和标识符）匹配实体。 此终结点支持模糊匹配。

在数据集中搜索实体

使用简单的文本查询搜索实体。 支持优化搜索的筛选器、主题、国家/地区和数据集。

按 ID 获取实体

按其唯一标识符检索单个实体记录，包括嵌套属性和相关属性。

获取相邻实体

返回与指定实体相邻的实体（例如，关联、家庭成员或相关公司）。

按属性获取相邻实体

返回特定属性的相关实体（例如 familyPerson、ownershipOwner、membershipMember）。

获取数据集目录

检索通过 OpenSanctions 提供的所有索引数据集的列表。

获取系统运行状况

执行系统运行状况检查以验证服务可用性。

获取匹配算法

列出系统使用的受支持实体匹配算法。

强制索引更新

如果使用有效的更新令牌授权，则触发重新索引作。

入门

  1. 在 OpenSanctions.org 创建帐户。
  2. API 密钥
  3. 在 Power Automate 或 Power Apps 中，使用 API 密钥创建新的连接。
  4. 使用连接器的作搜索、匹配或提取实体。

获取凭据

访问 https://www.opensanctions.org/api/ 以请求 API 密钥。 你将收到 ApiKey 应在标头中使用的 Authorization 值：

授权：ApiKey YOUR_API_KEY

已知问题和限制

  • 响应结构是动态的;使用 Power Automate 中的“分析 JSON”访问嵌套值。
  • match终结点search可能会返回大型响应，具体取决于数据集范围。
  • 某些终结点需要有效的 dataset 参数（例如， sanctions）。
  • 按不受支持的字段（如 score）排序可能会触发错误。
  • API 速率限制可能会根据计划应用。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
API密钥 securestring 此 api 的api_key True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

协调数据集的实体

提供与 Google Refine （OpenRefine） API 兼容的对帐终结点。 使用此函数可从外部工具（如 OpenRefine）批量匹配或验证数据集的实体名称。
在数据集中搜索实体

使用此终结点按数据集中的名称或关键字搜索实体。 支持字段筛选器、模糊匹配和可选分面。
将实体与数据集匹配

使用此终结点可以使用模糊名称、出生日期和国籍条件将人员或公司与数据集匹配。 返回具有置信度阈值的评分匹配结果。
强制重新生成索引

触发手动重新生成搜索索引。 需要有效的更新令牌进行授权。 在发生数据或结构更改时，使用此属性刷新数据集。
按 ID 获取实体

返回由其 ID 指定的实体的完整记录，包括所有权、关联和链接属性等相关数据。
按属性获取相关实体

通过特定属性（如所有权、家庭关系或标识符）返回与给定实体相关的实体。 可用于详细浏览图形关系。
检查 API 运行状况

返回一个简单的状态响应，确认 API 可访问且可作。 通常用于监视工具或 Kubernetes 实时性探测。
检查搜索索引就绪情况

返回搜索索引的状态，以指示 API 是否已准备好处理查询。 可用于监视启动和部署准备情况。
获取与实体相邻的实体

返回连接到指定实体的实体，例如链接人员、公司、标识符或制裁。 可用于浏览 OpenSanctions 数据集中的图形关系。
获取原始实体语句

以 OpenSanctions 数据库中的单个语句的形式返回精细实体数据。 每个语句表示从源数据中提取的单个事实（例如名称、地址、出生日期）。
获取支持的匹配算法

检索 API 用于实体比较和结果排名的所有支持的匹配和评分算法的列表。
获取数据集目录

返回包含 OpenSanctions API 中所有可用和索引数据集的完整服务目录。 可用于发现数据集名称和元数据。

协调数据集的实体

操作 ID:
Reconcile_reconcile__dataset__get

提供与 Google Refine （OpenRefine） API 兼容的对帐终结点。 使用此函数可从外部工具（如 OpenRefine）批量匹配或验证数据集的实体名称。

参数

名称 密钥 必需 类型 说明
目标数据集
 dataset True string

要对其进行协调的数据集或集合名称。

返回

FreebaseManifest
FreebaseManifest

在数据集中搜索实体

操作 ID:
Search_search__dataset__get

使用此终结点按数据集中的名称或关键字搜索实体。 支持字段筛选器、模糊匹配和可选分面。

参数

名称 密钥 必需 类型 说明
目标数据集
 dataset True string

要在其中搜索的数据集或集合。
搜索查询
 q string

要搜索的文本，例如名称或关键字。
架构筛选器
 schema string

将结果限制为特定架构（例如 Person）。
包含的数据集
 include_dataset array

仅返回这些数据集中的实体。
排除的数据集
 exclude_dataset array

从这些数据集中排除实体。
排除的架构
 exclude_schema array

排除这些架构类型的实体。
自日期以来已更改
 changed_since string

仅包括自此 ISO 日期以来更新的实体。
国家/地区筛选器
 countries array

按国家/地区代码（ISO 3166-1 alpha-2）进行筛选。
主题筛选器
 topics array

将结果限制为使用主题标记的实体。
数据集筛选器
 datasets array

按数据集标识符进行筛选。
字段筛选器
 filter array

使用语法“field：value”筛选字段，例如 properties.birthDate：1985。
结果限制
 limit integer

要返回的最大结果数（1-500）。
结果偏移量
 offset integer

分页结果的起始偏移量。
排序方式
 sort array

按字段（例如 score：desc）对结果进行排序。
目标（已弃用）
 target string

已弃用。 请改用“topics”参数。
模糊搜索
 fuzzy boolean

启用模糊文本匹配（近似搜索）。
简单模式
 simple boolean

通过跳过详细元数据来简化结果。
Facet 字段
 facets array

返回这些字段的分面计数。
筛选器运算符
 filter_op string

组合多个筛选器（AND/OR）的逻辑。

返回

SearchResponse
SearchResponse

将实体与数据集匹配

操作 ID:
Match_match__dataset__post

使用此终结点可以使用模糊名称、出生日期和国籍条件将人员或公司与数据集匹配。 返回具有置信度阈值的评分匹配结果。

参数

名称 密钥 必需 类型 说明
目标数据集名称
 dataset True string

要在其中运行匹配查询的数据集或集合名称。
结果限制
 limit integer

要返回的最大匹配项数（1-500）。
匹配阈值
 threshold double

要包括结果的最小分数（0-1）。
切口分数
 cutoff double

最佳匹配截止的最低可接受分数。
算法版本
 algorithm string

要使用的匹配算法，例如 logic-v1。
包含的数据集
 include_dataset array

要显式包含在匹配中的数据集。
排除的架构
 exclude_schema array

要从匹配进程中排除的架构。
排除的数据集
 exclude_dataset array

要从匹配过程中排除的数据集。
主题筛选器
 topics array

将匹配项限制为使用这些主题标记的实体。
自日期以来已更改
 changed_since string

仅包括自此 ISO 日期以来更改的实体。
排除的实体 ID
 exclude_entity_ids array

在匹配期间要忽略的实体 ID。 用于筛选误报或以前审阅的实体。
内容类型标头
 Content-Type string

请求正文的内容类型（application/json）。
权重
 weights object
config
 config object

特定于算法的配置参数。
queries
 queries True object

返回

EntityMatchResponse
EntityMatchResponse

强制重新生成索引

操作 ID:
Force_update_updatez_post

触发手动重新生成搜索索引。 需要有效的更新令牌进行授权。 在发生数据或结构更改时，使用此属性刷新数据集。

参数

名称 密钥 必需 类型 说明
更新令牌
 token string

授权索引重新生成所需的 API 令牌。
同步模式
 sync boolean

同步运行并等待索引完成。

返回

StatusResponse
StatusResponse

按 ID 获取实体

操作 ID:
Fetch_entity_entities__entity_id__get

返回由其 ID 指定的实体的完整记录，包括所有权、关联和链接属性等相关数据。

参数

名称 密钥 必需 类型 说明
实体标识符
 entity_id True string

要检索的实体的唯一 ID。
包括嵌套实体
 nested boolean

在响应中包含链接实体或相关实体。

返回

动态 JSON 对象。 允许所有字段类型，而无需验证。

response
object

按属性获取相关实体

操作 ID:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

通过特定属性（如所有权、家庭关系或标识符）返回与给定实体相关的实体。 可用于详细浏览图形关系。

参数

名称 密钥 必需 类型 说明
实体标识符
 entity_id True string

要提取其相关项的实体的唯一 ID。
属性名称
 property_name True string

用于提取相关实体的属性名称。
排序方式
 sort array

按字段（例如 score：desc）对相关实体进行排序。
结果限制
 limit integer

要返回的相关实体的最大数目（1-500）。
结果偏移量
 offset integer

分页相关结果的起始偏移量。

返回

动态 JSON 结构重新表示相关实体。 每个属性可能包含字符串或嵌套实体对象的数组。

response
object

检查 API 运行状况

操作 ID:
Healthz_healthz_get

返回一个简单的状态响应，确认 API 可访问且可作。 通常用于监视工具或 Kubernetes 实时性探测。

返回

StatusResponse
StatusResponse

检查搜索索引就绪情况

操作 ID:
Readyz_readyz_get

返回搜索索引的状态，以指示 API 是否已准备好处理查询。 可用于监视启动和部署准备情况。

返回

StatusResponse
StatusResponse

获取与实体相邻的实体

操作 ID:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

返回连接到指定实体的实体，例如链接人员、公司、标识符或制裁。 可用于浏览 OpenSanctions 数据集中的图形关系。

参数

名称 密钥 必需 类型 说明
实体标识符
 entity_id True string

要检索其连接的实体的唯一 ID。
排序方式
 sort array

按字段（例如 score：desc）对结果进行排序。
结果限制
 limit integer

要返回的相关实体的最大数目（1-500）。
结果偏移量
 offset integer

分页相关实体的起始偏移量。

返回

response
object

获取原始实体语句

操作 ID:
Statements_statements_get

以 OpenSanctions 数据库中的单个语句的形式返回精细实体数据。 每个语句表示从源数据中提取的单个事实（例如名称、地址、出生日期）。

参数

名称 密钥 必需 类型 说明
数据集名称
 dataset string

将结果限制为来自此数据集的语句。
实体标识符
 entity_id string

返回链接到此实体 ID 的语句。
规范 ID
 canonical_id string

获取规范实体 ID 的语句。
属性筛选器
 prop string

按属性名称筛选语句。
属性值
 value string

包含此属性值的筛选器语句。
架构筛选器
 schema string

将语句限制为给定架构的实体。
排序方式
 sort array

按字段（例如 timestamp：desc）对结果进行排序。
结果限制
 limit integer

要返回的最大语句数（1-5000）。
结果偏移量
 offset integer

分页结果的起始偏移量。

返回

StatementResponse
StatementResponse

获取支持的匹配算法

操作 ID:
Algorithms_algorithms_get

检索 API 用于实体比较和结果排名的所有支持的匹配和评分算法的列表。

返回

AlgorithmResponse
AlgorithmResponse

获取数据集目录

操作 ID:
Catalog_catalog_get

返回包含 OpenSanctions API 中所有可用和索引数据集的完整服务目录。 可用于发现数据集名称和元数据。

返回

response
object

定义

算法

名称 路径 类型 说明
姓名
 name string

匹配或评分算法的名称。
描述
 description string

有关算法执行的作的简短说明。
features
 features object

已弃用。 改用 docs 属性。
AlgorithmDocs
 docs AlgorithmDocs

评分算法的文档。

AlgorithmDocs

评分算法的文档。

名称 路径 类型 说明
姓名
 name string
描述
 description
config
 config object
features
 features object

AlgorithmResponse

名称 路径 类型 说明
算法
 algorithms array of Algorithm
默认
 default string
最好
 best string

EntityMatchResponse

名称 路径 类型 说明
回应
 responses object
匹配器
 matcher object

有关用于为此请求评分的匹配程序的信息。 弃用，请改用 /algorithms 终结点。
limit
 limit integer

EntityResponse

名称 路径 类型 说明
id
 id string
字幕
 caption string
架构
 schema string
属性
 properties object
数据集
 datasets array of string
引用
 referents array of string
目标
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

名称 路径 类型 说明
版本
 versions array of string
姓名
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
文档
 documentation string
批处理大小
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

名称 路径 类型 说明
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

名称 路径 类型 说明
姓名
 name string
标签
 label string
类型
 type string
默认
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

名称 路径 类型 说明
id
 id string
姓名
 name string

FreebaseManifestExtendProposeProperties

名称 路径 类型 说明
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

名称 路径 类型 说明
网址
 url string
width
 width integer
身高
 height integer

FreebaseManifestSuggest

名称 路径 类型 说明
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

名称 路径 类型 说明
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

名称 路径 类型 说明
网址
 url string

FreebaseType

名称 路径 类型 说明
id
 id string
姓名
 name string
描述
 description

SearchResponse

名称 路径 类型 说明
limit
 limit integer
偏移
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
方面
 facets object

Statement

名称 路径 类型 说明
id
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
支柱
 prop string
prop_type
 prop_type string
架构
 schema string
value
 value string
original_value
 original_value
数据集
 dataset string
lang
 lang
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

名称 路径 类型 说明
limit
 limit integer
偏移
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

名称 路径 类型 说明
状态
 status string

TotalSpec

名称 路径 类型 说明
value
 value integer
关系
 relation string

对象

这是类型“object”。