次の方法で共有

OpenSanctions (独立した発行元) (プレビュー)

OpenSanctions API を使用すると、グローバルな承認と政治的に公開された人物 (PEP) データベースを検索してクエリを実行できます。 エンティティの照合、テキスト検索、エンティティの取得、詳細なステートメント レベルのデータのエンドポイントを提供します。 これを使用して、承認リストに対して人や企業をチェックしたり、OpenSanctions エンティティ グラフを調べることができます。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate（パワーオートメート） Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 OpenSanctions
URL https://developments.substack.com
Email dan.romano@swolcat.com
コネクタ メタデータ
パブリッシャー krautrocker
Website https://www.opensanctions.org/
プライバシー ポリシー https://www.opensanctions.org/docs/privacy/
カテゴリ データ

OpenSanctions

概要

OpenSanctions API は、政治的、犯罪的、または経済的関心のある人物や企業のグローバル データベースへのアクセスを提供します。 これは、世界中の数百の承認リスト、政治的に公開された人物 (PEP)、ウォッチリストからのデータを集計します。

このコネクタを使用すると、エンティティの照合、検索、フェッチ、リレーションシップの探索、データセット カバレッジの分析を行うことができます。

詳細については、 OpenSanctions.org を参照してください。

Publisher - Dan Romano (swolcat)

[前提条件]

このコネクタを使用するには、OpenSanctions の API キーが必要です。 無料キーの登録: https://www.opensanctions.org/api/

サポートされている操作

データセット別にエンティティを照合する

名前と、生年月日、国籍、識別子などの省略可能なフィールドに基づいてエンティティを照合します。 このエンドポイントでは、あいまい一致がサポートされています。

データセット内のエンティティを検索する

単純なテキスト クエリを使用してエンティティを検索します。 絞り込み検索用のフィルター、トピック、国、データセットをサポートします。

ID でエンティティを取得する

入れ子になった属性や関連する属性など、一意の識別子で 1 つのエンティティ レコードを取得します。

隣接するエンティティを取得する

指定したエンティティに隣接するエンティティ (たとえば、関連付け、家族、または関連する会社) を返します。

プロパティで隣接するエンティティを取得する

特定のプロパティの関連エンティティ (familyPerson、ownershipOwner、membershipMember など) を返します。

データセット カタログを取得する

OpenSanctions を使用して使用可能なすべてのインデックス付きデータセットの一覧を取得します。

システムの正常性を取得する

システム正常性チェックを実行して、サービスの可用性を確認します。

一致するアルゴリズムを取得する

システムで使用されるサポートされているエンティティ照合アルゴリズムを一覧表示します。

インデックスの強制的な更新

有効な更新トークンで承認されている場合は、インデックス再作成操作をトリガーします。

はじめに

  1. OpenSanctions.org でアカウントを作成します。
  2. API キー
  3. Power Automate または Power Apps で、API キーを使用して新しい接続を作成します。
  4. コネクタのアクションを使用して、エンティティを検索、照合、またはフェッチします。

資格情報の取得

API キーを要求するには、 https://www.opensanctions.org/api/ にアクセスしてください。 Authorization ヘッダーで使用する必要があるApiKey値を受け取ります。

承認: ApiKey YOUR_API_KEY

既知の問題と制限事項

  • 応答構造は動的です。入れ子になった値にアクセスするには、Power Automate で "JSON の解析" を使用します。
  • searchエンドポイントとmatch エンドポイントは、データセットのスコープに応じて大きな応答を返す場合があります。
  • エンドポイントによっては、有効な dataset パラメーター ( sanctions など) が必要です。
  • サポートされていないフィールド ( score など) で並べ替えた場合、エラーが発生する可能性があります。
  • API レートの制限は、プランによっては適用される場合があります。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。
デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ Description 必須
APIキー securestring この API のapi_key 正しい

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

API の正常性状態を確認する

API が到達可能で操作可能であることを確認する単純な状態応答を返します。 監視ツールまたは Kubernetes のライブネス プローブでよく使用されます。
ID でエンティティを取得する

所有権、関連付け、リンクされたプロパティなどの関連データを含め、ID で指定されたエンティティの完全なレコードを返します。
インデックスの再生成を強制する

検索インデックスの手動再構築をトリガーします。 承認のために有効な更新トークンが必要です。 これを使用して、データまたは構造の変更が発生したときにデータセットを更新します。
エンティティに隣接するエンティティを取得する

リンクされたユーザー、会社、識別子、承認など、指定されたエンティティに接続されているエンティティを返します。 OpenSanctions データセットでグラフのリレーションシップを探索する場合に便利です。
エンティティをデータセットと照合する

このエンドポイントを使用して、あいまいな名前、生年月日、国籍の条件を使用して、データセットに対してユーザーまたは企業を照合します。 信頼度しきい値を持つスコア付けされた一致結果を返します。
サポートされている照合アルゴリズムを取得する

エンティティの比較と結果のランク付けに API で使用される、サポートされているすべての照合アルゴリズムとスコアリング アルゴリズムの一覧を取得します。
データセット カタログを取得する

OpenSanctions API で使用可能なすべてのデータセットとインデックス付きデータセットを含む完全なサービス カタログを返します。 データセット名とメタデータを検出する場合に便利です。
データセットのエンティティを調整する

Google Refine (OpenRefine) API と互換性のある調整エンドポイントを提供します。 これを使用して、OpenRefine などの外部ツールからデータセットに対してエンティティ名を一括照合または検証します。
データセット内のエンティティを検索する

このエンドポイントを使用して、データセット内の名前またはキーワードでエンティティを検索します。 フィールド フィルター、あいまい一致、およびオプションのファセットをサポートします。
プロパティ別に関連エンティティを取得する

所有権、家族のつながり、識別子など、特定のプロパティを通じて、特定のエンティティに関連するエンティティを返します。 グラフのリレーションシップを詳しく調べることができます。
検索インデックスの準備状況を確認する

API がクエリを処理する準備ができているかどうかを示す検索インデックスの状態を返します。 スタートアップとデプロイの準備状況を監視するのに役立ちます。
生のエンティティ ステートメントを取得する

OpenSanctions データベースから個々のステートメントとして詳細なエンティティ データを返します。 各ステートメントは、ソース データから抽出された 1 つのファクト (名前、住所、生年月日など) を表します。

API の正常性状態を確認する

操作 ID:
Healthz_healthz_get

API が到達可能で操作可能であることを確認する単純な状態応答を返します。 監視ツールまたは Kubernetes のライブネス プローブでよく使用されます。

戻り値

StatusResponse
StatusResponse

ID でエンティティを取得する

操作 ID:
Fetch_entity_entities__entity_id__get

所有権、関連付け、リンクされたプロパティなどの関連データを含め、ID で指定されたエンティティの完全なレコードを返します。

パラメーター

名前 キー 必須 型 説明
エンティティ識別子
 entity_id True string

取得するエンティティの一意の ID。
入れ子になったエンティティを含める
 nested boolean

応答にリンクされたエンティティまたは関連エンティティを含めます。

戻り値

動的 JSON オブジェクト。 検証なしですべてのフィールド型を許可します。

response
object

インデックスの再生成を強制する

操作 ID:
Force_update_updatez_post

検索インデックスの手動再構築をトリガーします。 承認のために有効な更新トークンが必要です。 これを使用して、データまたは構造の変更が発生したときにデータセットを更新します。

パラメーター

名前 キー 必須 型 説明
トークンの更新
 token string

インデックスの再構築を承認するために必要な API トークン。
同期モード
 sync boolean

同期的に実行し、インデックスの完了を待ちます。

戻り値

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:
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:
Algorithms_algorithms_get

エンティティの比較と結果のランク付けに API で使用される、サポートされているすべての照合アルゴリズムとスコアリング アルゴリズムの一覧を取得します。

戻り値

AlgorithmResponse
AlgorithmResponse

データセット カタログを取得する

操作 ID:
Catalog_catalog_get

OpenSanctions API で使用可能なすべてのデータセットとインデックス付きデータセットを含む完全なサービス カタログを返します。 データセット名とメタデータを検出する場合に便利です。

戻り値

response
object

データセットのエンティティを調整する

操作 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

Deprecated. 代わりに 'topics' パラメーターを使用してください。
あいまい検索
 fuzzy boolean

あいまいテキスト一致 (近似検索) を有効にします。
シンプル モード
 simple boolean

詳細なメタデータをスキップして結果を簡略化します。
ファセット フィールド
 facets array

これらのフィールドのファセット数を返します。
フィルター演算子
 filter_op string

複数のフィルター (AND/OR) を結合するロジック。

戻り値

SearchResponse
SearchResponse

プロパティ別に関連エンティティを取得する

操作 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

検索インデックスの準備状況を確認する

操作 ID:
Readyz_readyz_get

API がクエリを処理する準備ができているかどうかを示す検索インデックスの状態を返します。 スタートアップとデプロイの準備状況を監視するのに役立ちます。

戻り値

StatusResponse
StatusResponse

生のエンティティ ステートメントを取得する

操作 ID:
Statements_statements_get

OpenSanctions データベースから個々のステートメントとして詳細なエンティティ データを返します。 各ステートメントは、ソース データから抽出された 1 つのファクト (名前、住所、生年月日など) を表します。

パラメーター

名前 キー 必須 型 説明
データセット名
 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

定義

アルゴリズム

名前 パス 型 説明
名前
 name string

照合アルゴリズムまたはスコアリング アルゴリズムの名前。
説明
 description string

アルゴリズムの機能の簡単な説明。
features
 features object

Deprecated. 代わりに、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
 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
 versions array of string
名前
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
説明書
 documentation string
batchSize
 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
 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
 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' です。