共用方式為

OpenSanctions（獨立出版商）（預覽版）

OpenSanctions API 讓你能搜尋並查詢全球制裁與政治暴露人物（PEP）資料庫。 它提供實體匹配、文字搜尋、實體檢索及細緻語句層級資料的端點。 你可以用它來核對個人或公司是否符合制裁名單，或探索 OpenSanctions 實體圖譜。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 開放制裁
URL https://developments.substack.com
Email dan.romano@swolcat.com
連接器中繼資料
Publisher 克勞特羅克
網站 https://www.opensanctions.org/
隱私策略 https://www.opensanctions.org/docs/privacy/
類別 資料

開放制裁

概觀

OpenSanctions API 提供存取全球政治、犯罪或經濟相關人士與公司的資料庫。 它彙整了全球數百份制裁名單、政治暴露者（PEPs）及觀察名單的數據。

你可以使用這個連接器來匹配、搜尋和擷取實體，探索關係，並分析資料集覆蓋率。

更多資訊請見 OpenSanctions.org。

發行商 - Dan Romano （swolcat）

先決條件

你需要從 OpenSanctions 取得 API 金鑰才能使用這個連接器。 請於以下網址註冊免費鑰匙： https://www.opensanctions.org/api/

支援的作業

依資料集匹配實體

根據姓名及可選欄位如出生日期、國籍和識別碼來配對實體。 此端點支援模糊匹配。

在資料集中搜尋實體

使用簡單的文字查詢搜尋實體。 支援篩選、主題、國家及資料集，進行精煉搜尋。

依 ID 取得實體

透過唯一識別碼檢索單一實體記錄，包括巢狀及相關屬性。

取得相鄰實體

與特定實體相鄰的報稅實體（例如，關聯人、家族成員或相關公司）。

依物業取得相鄰實體

針對特定財產申報相關實體（例如，familyPerson、ownershipOwner、membership）。

取得資料集目錄

檢索所有透過 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 中使用「Parse JSON」來存取巢狀值。
  • search與match端點可能會根據資料集範圍回傳較大的回應。
  • 有些端點需要一個有效的 dataset 參數（例如， sanctions）。
  • 依不支援欄位（如 score）排序可能會觸發錯誤。
  • API 費率限制可能會依你的方案而定。

正在建立連線

連接器支援以下認證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
API 密鑰 (api_key) securestring 此 API 的api_key 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

依 ID 取得實體

回傳由其 ID 指定的實體完整紀錄，包括相關資料，如所有權、關聯及連結屬性。
依屬性取得相關實體

申報與特定實體相關的實體，透過特定屬性，如所有權、家族關係或識別碼。 有助於詳細探討圖關係。
力指數再生

會觸發手動重建搜尋索引。 需要有效的更新令牌來授權。 當資料或結構發生變動時，利用此方法刷新資料集。
取得原始實體陳述

從 OpenSanctions 資料庫中以個別語句形式回傳細緻實體資料。 每個陳述代表從來源資料中擷取的單一事實（例如姓名、地址、出生日期）。
取得支援的配對演算法

檢索所有支援的 API 用於實體比較與結果排名的匹配與評分演算法清單。
取得資料集目錄

回傳包含 OpenSanctions API 中所有可用且已索引資料集的完整服務目錄。 對於發現資料集名稱和元資料非常有用。
在資料集中搜尋實體

使用此端點透過名稱或關鍵字在資料集中搜尋實體。 支援欄位濾波器、模糊匹配及可選的分面處理。
將實體與資料集進行比對

利用此端點將個人或公司與模糊姓名、出生日期及國籍標準的資料集進行比對。 回報以信心門檻評分配對結果。
檢查 API 健康狀態

回傳一個簡單的狀態回應，確認 API 可存取且運作正常。 通常被監控工具或 Kubernetes 活度探測器使用。
檢查搜尋索引準備度

回傳搜尋索引的狀態，以指示 API 是否準備好處理查詢。 有助於監控啟動與部署準備狀況。
讓實體與實體相鄰

與指定實體相關的申報實體，例如連結的人、公司、識別碼或制裁。 對於探索 OpenSanctions 資料集中的圖關係非常有用。
資料集的對帳實體

提供與 Google Refine（OpenRefine）API 相容的對帳端點。 利用此方法批量比對或驗證實體名稱與外部工具（如 OpenRefine）的資料集。

依 ID 取得實體

作業識別碼：
Fetch_entity_entities__entity_id__get

回傳由其 ID 指定的實體完整紀錄，包括相關資料，如所有權、關聯及連結屬性。

參數

名稱 機碼 必要 類型 Description
實體識別碼
 entity_id True string

要取得實體的唯一 ID。
包含巢狀實體
 nested boolean

回應中包含連結或相關實體。

傳回

動態 JSON 物件。 允許所有欄位類型且無需驗證。

response
object

依屬性取得相關實體

作業識別碼：
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

申報與特定實體相關的實體，透過特定屬性，如所有權、家族關係或識別碼。 有助於詳細探討圖關係。

參數

名稱 機碼 必要 類型 Description
實體識別碼
 entity_id True string

要抓取相關物品的實體唯一 ID。
屬性名稱
 property_name True string

屬性名稱用於擷取相關實體。
排序順序
 sort array

依欄位排序相關實體，例如 score：desc。
結果限制
 limit integer

最多可返回的相關實體數量（1–500）。
結果偏移
 offset integer

針對頁碼相關結果的起始偏移。

傳回

動態 JSON 結構，取代相關實體。 每個屬性可能包含字串陣列或巢狀實體物件。

response
object

力指數再生

作業識別碼：
Force_update_updatez_post

會觸發手動重建搜尋索引。 需要有效的更新令牌來授權。 當資料或結構發生變動時，利用此方法刷新資料集。

參數

名稱 機碼 必要 類型 Description
更新權杖
 token string

授權索引重建需要 API 代幣。
同步模式
 sync boolean

同步執行並等待索引完成。

傳回

狀態回應
StatusResponse

取得原始實體陳述

作業識別碼：
Statements_statements_get

從 OpenSanctions 資料庫中以個別語句形式回傳細緻實體資料。 每個陳述代表從來源資料中擷取的單一事實（例如姓名、地址、出生日期）。

參數

名稱 機碼 必要 類型 Description
資料集名稱
 dataset string

將結果限制為本資料集中的陳述。
實體識別碼
 entity_id string

與此實體ID相關的退還報表。
正典識別
 canonical_id string

取出典型實體 ID 的 fetch 語句。
屬性篩選
 prop string

用屬性名稱篩選語句。
屬性值
 value string

包含此屬性值的過濾語句。
模式過濾器
 schema string

限制語句只能使用給定結構的實體。
排序順序
 sort array

依欄位排序結果，例如時間戳：說明。
結果限制
 limit integer

回傳的最大語句數（1–5000）。
結果偏移
 offset integer

起始偏移以顯示分頁結果。

傳回

陳述回應
StatementResponse

取得支援的配對演算法

作業識別碼：
Algorithms_algorithms_get

檢索所有支援的 API 用於實體比較與結果排名的匹配與評分演算法清單。

傳回

演算法響應
AlgorithmResponse

取得資料集目錄

作業識別碼：
Catalog_catalog_get

回傳包含 OpenSanctions API 中所有可用且已索引資料集的完整服務目錄。 對於發現資料集名稱和元資料非常有用。

傳回

response
object

在資料集中搜尋實體

作業識別碼：
Search_search__dataset__get

使用此端點透過名稱或關鍵字在資料集中搜尋實體。 支援欄位濾波器、模糊匹配及可選的分面處理。

參數

名稱 機碼 必要 類型 Description
目標資料集
 dataset True string

可供搜尋的資料集或集合。
搜尋查詢
 q string

需要搜尋的文字，例如名字或關鍵字。
模式過濾器
 schema string

將結果限制在特定圖式（例如，人格）。
收錄資料集
 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（已棄用）
 target string

Deprecated. 改用「主題」參數。
模糊搜尋
 fuzzy boolean

啟用模糊文字匹配（近似搜尋）。
簡單模式
 simple boolean

透過跳過詳細的元資料簡化結果。
Facet 欄位
 facets array

這些欄位的面數回傳。
篩選運算子
 filter_op string

結合多個濾波器（AND/OR）的邏輯。

傳回

搜尋回應
SearchResponse

將實體與資料集進行比對

作業識別碼：
Match_match__dataset__post

利用此端點將個人或公司與模糊姓名、出生日期及國籍標準的資料集進行比對。 回報以信心門檻評分配對結果。

參數

名稱 機碼 必要 類型 Description
目標資料集名稱
 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 日期以來變更的實體。
排除實體識別碼
 exclude_entity_ids array

配對時要忽略的實體ID。 用於過濾誤報或先前審查過的實體。
內容類型標頭
 Content-Type string

請求主體的內容型別（application/json）。
重量
 weights object
config
 config object

演算法特定的配置參數。
queries
 queries True object

傳回

EntityMatchResponse
EntityMatchResponse

檢查 API 健康狀態

作業識別碼：
Healthz_healthz_get

回傳一個簡單的狀態回應，確認 API 可存取且運作正常。 通常被監控工具或 Kubernetes 活度探測器使用。

傳回

狀態回應
StatusResponse

檢查搜尋索引準備度

作業識別碼：
Readyz_readyz_get

回傳搜尋索引的狀態，以指示 API 是否準備好處理查詢。 有助於監控啟動與部署準備狀況。

傳回

狀態回應
StatusResponse

讓實體與實體相鄰

作業識別碼：
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

與指定實體相關的申報實體，例如連結的人、公司、識別碼或制裁。 對於探索 OpenSanctions 資料集中的圖關係非常有用。

參數

名稱 機碼 必要 類型 Description
實體識別碼
 entity_id True string

要取得連接的實體唯一 ID。
排序順序
 sort array

依欄位排序結果，例如：score：desc。
結果限制
 limit integer

最多可返回的相關實體數量（1–500）。
結果偏移
 offset integer

起始偏移用於分頁相關實體。

傳回

response
object

資料集的對帳實體

作業識別碼：
Reconcile_reconcile__dataset__get

提供與 Google Refine（OpenRefine）API 相容的對帳端點。 利用此方法批量比對或驗證實體名稱與外部工具（如 OpenRefine）的資料集。

參數

名稱 機碼 必要 類型 Description
目標資料集
 dataset True string

資料集或集合名稱以進行對調。

傳回

自由基清單
FreebaseManifest

定義

演算法

名稱 路徑 類型 Description
名稱
 name string

配對或計分演算法的名稱。
說明
 description string

簡要說明這個演算法的功能。
features
 features object

Deprecated. 還是用這個 docs 房產吧。
演算法文件
 docs AlgorithmDocs

評分演算法的文件。

演算法文件

評分演算法的文件。

名稱 路徑 類型 Description
名稱
 name string
說明
 description
config
 config object
features
 features object

演算法響應

名稱 路徑 類型 Description
演算法
 algorithms array of Algorithm
預設
 default string
最好的
 best string

EntityMatchResponse

名稱 路徑 類型 Description
回應
 responses object
匹配器
 matcher object

關於用於評分此請求的匹配者的資訊。 已棄用，改用 /algorithms endpoint。
limit
 limit integer

EntityResponse

名稱 路徑 類型 Description
識別碼
 id string
字幕
 caption string
結構描述
 schema string
properties
 properties object
數據集
 datasets array of string
指涉物
 referents array of string
目標
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

自由基清單

名稱 路徑 類型 Description
versions
 versions array of string
名稱
 name string
識別碼空間
 identifierSpace string
schemaSpace
 schemaSpace string
文件
 documentation string
批次大小
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
自由基礎顯現建議
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

名稱 路徑 類型 Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

名稱 路徑 類型 Description
名稱
 name string
標籤
 label string
型別
 type string
預設
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

名稱 路徑 類型 Description
識別碼
 id string
名稱
 name string

FreebaseManifestExtendProposeProperties

名稱 路徑 類型 Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

名稱 路徑 類型 Description
url
 url string
寬度
 width integer
height
 height integer

自由基礎顯現建議

名稱 路徑 類型 Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

名稱 路徑 類型 Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

名稱 路徑 類型 Description
url
 url string

自由基型

名稱 路徑 類型 Description
識別碼
 id string
名稱
 name string
說明
 description

搜尋回應

名稱 路徑 類型 Description
limit
 limit integer
位移
 offset integer
全規格
 total TotalSpec
results
 results array of EntityResponse
切面
 facets object

Statement

名稱 路徑 類型 Description
識別碼
 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

陳述回應

名稱 路徑 類型 Description
limit
 limit integer
位移
 offset integer
全規格
 total TotalSpec
results
 results array of Statement

狀態回應

名稱 路徑 類型 Description
狀態
 status string

全規格

名稱 路徑 類型 Description
value
 value integer
關聯
 relation string

物件

這是類型 'object'。