Dela via

OpenSanctions (Independent Publisher) (förhandsversion)

Med OpenSanctions-API:et kan du söka efter och fråga efter den globala databasen för sanktioner och politiskt exponerade personer (PEP). Den innehåller slutpunkter för entitetsmatchning, textsökning, entitetshämtning och detaljerade data på instruktionsnivå. Använd den för att kontrollera personer eller företag mot sanktionslistor eller utforska entitetsdiagrammet OpenSanctions.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Premie Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     – Azure Government-regioner
     – Regioner i Azure Kina
     - US Department of Defense (DoD)
Power Apps Premie Alla Power Apps-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Premie Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Namn OpenSanctions
URL https://developments.substack.com
E-postmeddelande dan.romano@swolcat.com
Metadata för anslutningsprogram
Utgivare krautrocker
Webbplats https://www.opensanctions.org/
Sekretesspolicy https://www.opensanctions.org/docs/privacy/
Kategorier Uppgifter

OpenSanctions

Översikt

OpenSanctions-API:et ger tillgång till en global databas med personer och företag av politiskt, kriminellt eller ekonomiskt intresse. Den sammanställer data från hundratals sanktionslistor, politiskt exponerade personer (PEP) och bevakningslistor över hela världen.

Du kan använda den här anslutningsappen för att matcha, söka efter och hämta entiteter, utforska relationer och analysera datamängdens täckning.

Läs mer på OpenSanctions.org.

Utgivare – Dan Romano (swolcat)

Förutsättningar

Du behöver en API-nyckel från OpenSanctions för att använda den här anslutningsappen. Registrera dig för en kostnadsfri nyckel på: https://www.opensanctions.org/api/

Åtgärder som stöds

Matcha entiteter efter datauppsättning

Matcha entiteter baserat på namn och valfria fält som födelsedatum, nationalitet och identifierare. Den här slutpunkten stöder fuzzy-matchning.

Söka efter entiteter i en datauppsättning

Sök efter entiteter med en enkel textfråga. Stöder filter, ämnen, länder och datauppsättningar för förfinade sökningar.

Hämta entitet efter ID

Hämta en enskild entitetspost med dess unika identifierare, inklusive kapslade och relaterade attribut.

Hämta intilliggande entiteter

Returnera entiteter intill en angiven entitet (t.ex. medarbetare, familjemedlemmar eller relaterade företag).

Hämta intilliggande entiteter efter egenskap

Returnera relaterade entiteter för en specifik egenskap (t.ex. familyPerson, ownershipOwner, membershipMember).

Hämta datamängdskatalog

Hämta listan över alla indexerade datauppsättningar som är tillgängliga via OpenSanctions.

Hämta systemhälsa

Utför en systemhälsokontroll för att verifiera tjänstens tillgänglighet.

Hämta matchande algoritmer

Lista algoritmer som stöds för entitetsmatchning som används av systemet.

Framtvinga indexuppdatering

Utlös en omindexeringsåtgärd om den har auktoriserats med en giltig uppdateringstoken.

Komma igång

  1. Skapa ett konto på OpenSanctions.org.
  2. En API-nyckel
  3. I Power Automate eller Power Apps skapar du en ny anslutning med hjälp av din API-nyckel.
  4. Använd anslutningsappens åtgärder för att söka efter, matcha eller hämta entiteter.

Hämta autentiseringsuppgifter

Besök https://www.opensanctions.org/api/ för att begära en API-nyckel. Du får ett ApiKey värde som ska användas i Authorization rubriken:

Auktorisering: ApiKey YOUR_API_KEY

Kända problem och begränsningar

  • Svarsstrukturerna är dynamiska. använd "Parsa JSON" i Power Automate för att komma åt kapslade värden.
  • Slutpunkterna search och match kan returnera stora svar beroende på datamängdsomfånget.
  • Vissa slutpunkter kräver en giltig dataset parameter (t.ex. sanctions).
  • Sortering efter fält som inte stöds (till exempel score) kan utlösa fel.
  • API-hastighetsbegränsningar kan gälla beroende på din plan.

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:
Standardinställning Parametrar för att skapa anslutning. Alla regioner Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn Typ Description Krävs
API-nyckel securestring Api_key för det här API:et Sann

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 100 60 sekunder

Åtgärder

Framtvinga indexförnyelse

Utlöser en manuell återskapande av sökindexet. Kräver en giltig uppdateringstoken för auktorisering. Använd detta för att uppdatera datamängden när data eller strukturändringar sker.
Hämta datamängdskatalog

Returnerar den fullständiga tjänstkatalogen som innehåller alla tillgängliga och indexerade datamängder i OpenSanctions-API:et. Användbart för att identifiera datauppsättningsnamn och metadata.
Hämta entitet efter ID

Returnerar den fullständiga posten för en entitet som anges av dess ID, inklusive relaterade data som ägarskap, associationer och länkade egenskaper.
Hämta entiteter intill en entitet

Returnerar entiteter som är anslutna till den angivna entiteten, till exempel länkade personer, företag, identifierare eller sanktioner. Användbart för att utforska grafrelationer i datauppsättningen OpenSanctions.
Hämta matchningsalgoritmer som stöds

Hämtar en lista över alla matchnings- och bedömningsalgoritmer som stöds som används av API:et för entitetsjämförelse och resultatrankning.
Hämta relaterade entiteter efter egenskap

Returnerar entiteter som är relaterade till en viss entitet via en specifik egenskap, till exempel ägarskap, familjeband eller identifierare. Användbart för att utforska grafrelationer i detalj.
Hämta råa entitetsinstruktioner

Returnerar detaljerade entitetsdata som enskilda instruktioner från OpenSanctions-databasen. Varje instruktion representerar ett enskilt faktum (t.ex. namn, adress, födelsedatum) som extraherats från källdata.
Kontrollera API-hälsostatus

Returnerar ett enkelt statussvar som bekräftar att API:et kan nås och fungerar. Används ofta av övervakningsverktyg eller Kubernetes liveness-avsökningar.
Kontrollera beredskapen för sökindex

Returnerar status för sökindexet för att ange om API:et är redo att hantera frågor. Användbart för övervakning av start- och distributionsberedskap.
Matcha entiteter mot en datauppsättning

Använd den här slutpunkten för att matcha personer eller företag mot en datamängd med hjälp av fuzzy-namn, födelsedatum och nationalitetskriterier. Returnerar poängsatta matchningsresultat med förtroendetrösklar.
Stämma av entiteter för en datauppsättning

Tillhandahåller en avstämningsslutpunkt som är kompatibel med Api:et Google Refine (OpenRefine). Använd detta för att massmatcha eller verifiera entitetsnamn mot en datauppsättning från ett externt verktyg, till exempel OpenRefine.
Söka efter entiteter i en datauppsättning

Använd den här slutpunkten för att söka efter entiteter efter namn eller nyckelord i en datauppsättning. Stöder fältfilter, fuzzy-matchning och valfri fasettering.

Framtvinga indexförnyelse

Åtgärds-ID:
Force_update_updatez_post

Utlöser en manuell återskapande av sökindexet. Kräver en giltig uppdateringstoken för auktorisering. Använd detta för att uppdatera datamängden när data eller strukturändringar sker.

Parametrar

Name Nyckel Obligatorisk Typ Description
Uppdatera token
 token string

API-token som krävs för att auktorisera återskapa index.
Synkroniseringsläge
 sync boolean

Kör synkront och vänta tills indexet har slutförts.

Returer

StatusResponse
StatusResponse

Hämta datamängdskatalog

Åtgärds-ID:
Catalog_catalog_get

Returnerar den fullständiga tjänstkatalogen som innehåller alla tillgängliga och indexerade datamängder i OpenSanctions-API:et. Användbart för att identifiera datauppsättningsnamn och metadata.

Returer

response
object

Hämta entitet efter ID

Åtgärds-ID:
Fetch_entity_entities__entity_id__get

Returnerar den fullständiga posten för en entitet som anges av dess ID, inklusive relaterade data som ägarskap, associationer och länkade egenskaper.

Parametrar

Name Nyckel Obligatorisk Typ Description
Entitets-ID
 entity_id True string

Unikt ID för den entitet som ska hämtas.
Inkludera kapslade entiteter
 nested boolean

Inkludera länkade eller relaterade entiteter i svaret.

Returer

Dynamiskt JSON-objekt. Tillåter alla fälttyper utan validering.

response
object

Hämta entiteter intill en entitet

Åtgärds-ID:
Fetch_Adjacent_Entities__entities__entity_id__adjacent_get

Returnerar entiteter som är anslutna till den angivna entiteten, till exempel länkade personer, företag, identifierare eller sanktioner. Användbart för att utforska grafrelationer i datauppsättningen OpenSanctions.

Parametrar

Name Nyckel Obligatorisk Typ Description
Entitets-ID
 entity_id True string

Unikt ID för entiteten vars anslutningar ska hämtas.
Sorteringsordning
 sort array

Sortera resultat efter fält, t.ex. score:desc.
Resultatgräns
 limit integer

Maximalt antal relaterade entiteter som ska returneras (1–500).
Resultatförskjutning
 offset integer

Startförskjutning för sidnumrerade relaterade entiteter.

Returer

response
object

Hämta matchningsalgoritmer som stöds

Åtgärds-ID:
Algorithms_algorithms_get

Hämtar en lista över alla matchnings- och bedömningsalgoritmer som stöds som används av API:et för entitetsjämförelse och resultatrankning.

Returer

AlgorithmResponse
AlgorithmResponse

Hämta relaterade entiteter efter egenskap

Åtgärds-ID:
Fetch_Adjacent_by_Property__entities__entity_id__adjacent__property_name__get

Returnerar entiteter som är relaterade till en viss entitet via en specifik egenskap, till exempel ägarskap, familjeband eller identifierare. Användbart för att utforska grafrelationer i detalj.

Parametrar

Name Nyckel Obligatorisk Typ Description
Entitets-ID
 entity_id True string

Unikt ID för entiteten vars relaterade objekt ska hämtas.
Egenskapsnamn
 property_name True string

Egenskapsnamn som används för att hämta relaterade entiteter.
Sorteringsordning
 sort array

Sortera relaterade entiteter efter fält, t.ex. score:desc.
Resultatgräns
 limit integer

Maximalt antal relaterade entiteter som ska returneras (1–500).
Resultatförskjutning
 offset integer

Startförskjutning för sidnumrerade relaterade resultat.

Returer

Dynamiska JSON-strukturrekonstruktioner relaterade entiteter. Varje egenskap kan innehålla matriser med strängar eller kapslade entitetsobjekt.

response
object

Hämta råa entitetsinstruktioner

Åtgärds-ID:
Statements_statements_get

Returnerar detaljerade entitetsdata som enskilda instruktioner från OpenSanctions-databasen. Varje instruktion representerar ett enskilt faktum (t.ex. namn, adress, födelsedatum) som extraherats från källdata.

Parametrar

Name Nyckel Obligatorisk Typ Description
Namn på datauppsättning
 dataset string

Begränsa resultat till instruktioner från den här datauppsättningen.
Entitets-ID
 entity_id string

Returinstruktioner som är länkade till det här entitets-ID:t.
Kanoniskt ID
 canonical_id string

Hämta instruktioner för det kanoniska entitets-ID:t.
Egenskapsfilter
 prop string

Filtrera uttryck efter egenskapsnamn.
Egenskapsvärde
 value string

Filterinstruktioner som innehåller det här egenskapsvärdet.
Schemafilter
 schema string

Begränsa instruktioner till entiteter i ett visst schema.
Sorteringsordning
 sort array

Sortera resultat efter fält, t.ex. tidsstämpel:desc.
Resultatgräns
 limit integer

Maximalt antal instruktioner som ska returneras (1–5 000).
Resultatförskjutning
 offset integer

Startförskjutning för sidnumrerade resultat.

Returer

StatementResponse
StatementResponse

Kontrollera API-hälsostatus

Åtgärds-ID:
Healthz_healthz_get

Returnerar ett enkelt statussvar som bekräftar att API:et kan nås och fungerar. Används ofta av övervakningsverktyg eller Kubernetes liveness-avsökningar.

Returer

StatusResponse
StatusResponse

Kontrollera beredskapen för sökindex

Åtgärds-ID:
Readyz_readyz_get

Returnerar status för sökindexet för att ange om API:et är redo att hantera frågor. Användbart för övervakning av start- och distributionsberedskap.

Returer

StatusResponse
StatusResponse

Matcha entiteter mot en datauppsättning

Åtgärds-ID:
Match_match__dataset__post

Använd den här slutpunkten för att matcha personer eller företag mot en datamängd med hjälp av fuzzy-namn, födelsedatum och nationalitetskriterier. Returnerar poängsatta matchningsresultat med förtroendetrösklar.

Parametrar

Name Nyckel Obligatorisk Typ Description
Måldatauppsättningens namn
 dataset True string

Datauppsättning eller samlingsnamn som matchningsfrågan ska köras på.
Resultatgräns
 limit integer

Maximalt antal matchningar att returnera (1–500).
Gränsvärde för matchning
 threshold double

Minsta poäng för att inkludera ett resultat (0–1).
Brytpoäng
 cutoff double

Lägsta godtagbara poäng för bästa matchningsavstängning.
Algoritmversion
 algorithm string

Matchande algoritm som ska användas, t.ex. logic-v1.
Inkluderade datauppsättningar
 include_dataset array

Datauppsättningar som uttryckligen ska inkluderas i matchningen.
Undantagna scheman
 exclude_schema array

Scheman som ska undantas från matchningsprocessen.
Exkluderade datauppsättningar
 exclude_dataset array

Datauppsättningar som ska undantas från matchningsprocessen.
Ämnesfilter
 topics array

Begränsa matchningar till entiteter som har taggats med de här avsnitten.
Har ändrats sedan datumet
 changed_since string

Inkludera endast entiteter som ändrats sedan det här ISO-datumet.
Undantagna entitets-ID:n
 exclude_entity_ids array

Entitets-ID:n som ska ignoreras under matchningen. Använd för att filtrera falska positiva identifieringar eller tidigare granskade entiteter.
Rubrik för innehållstyp
 Content-Type string

Innehållstyp för begärandetexten (program/json).
Vikter
 weights object
config
 config object

Algoritmspecifika konfigurationsparametrar.
queries
 queries True object

Returer

EntityMatchResponse
EntityMatchResponse

Stämma av entiteter för en datauppsättning

Åtgärds-ID:
Reconcile_reconcile__dataset__get

Tillhandahåller en avstämningsslutpunkt som är kompatibel med Api:et Google Refine (OpenRefine). Använd detta för att massmatcha eller verifiera entitetsnamn mot en datauppsättning från ett externt verktyg, till exempel OpenRefine.

Parametrar

Name Nyckel Obligatorisk Typ Description
Måldatauppsättning
 dataset True string

Datauppsättnings- eller samlingsnamn att stämma av mot.

Returer

FreebaseManifest
FreebaseManifest

Söka efter entiteter i en datauppsättning

Åtgärds-ID:
Search_search__dataset__get

Använd den här slutpunkten för att söka efter entiteter efter namn eller nyckelord i en datauppsättning. Stöder fältfilter, fuzzy-matchning och valfri fasettering.

Parametrar

Name Nyckel Obligatorisk Typ Description
Måldatauppsättning
 dataset True string

Datauppsättning eller samling för sökning inom.
Sökfråga
 q string

Text att söka efter, till exempel ett namn eller nyckelord.
Schemafilter
 schema string

Begränsa resultatet till ett specifikt schema (t.ex. Person).
Inkluderade datauppsättningar
 include_dataset array

Returnera endast entiteter från dessa datauppsättningar.
Exkluderade datauppsättningar
 exclude_dataset array

Undanta entiteter från dessa datauppsättningar.
Undantagna scheman
 exclude_schema array

Undanta entiteter av dessa schematyper.
Har ändrats sedan datumet
 changed_since string

Inkludera endast entiteter som har uppdaterats sedan det här ISO-datumet.
Landsfilter
 countries array

Filtrera efter landskoder (ISO 3166-1 alpha-2).
Ämnesfilter
 topics array

Begränsa resultaten till entiteter som är taggade med ämnen.
Datauppsättningsfilter
 datasets array

Filtrera efter datauppsättningsidentifierare.
Fältfilter
 filter array

Använd syntaxen "field:value" för att filtrera fält, t.ex. properties.birthDate:1985.
Resultatgräns
 limit integer

Maximalt antal resultat som ska returneras (1–500).
Resultatförskjutning
 offset integer

Startförskjutning för sidiga resultat.
Sorteringsordning
 sort array

Sortera resultat efter fält, t.ex. score:desc.
Mål (inaktuellt)
 target string

Deprecated. Använd parametern "topics" i stället.
Fuzzy-sökning
 fuzzy boolean

Aktivera fuzzy textmatchning (ungefärlig sökning).
Enkelt läge
 simple boolean

Förenkla resultatet genom att hoppa över detaljerade metadata.
Fasetteringsfält
 facets array

Returnera antal fasetter för dessa fält.
Filteroperatorn
 filter_op string

Logik för att kombinera flera filter (AND/OR).

Returer

SearchResponse
SearchResponse

Definitioner

Algorithm

Name Sökväg Typ Description
name
 name string

Namnet på matchnings- eller bedömningsalgoritmen.
beskrivning
 description string

Kort beskrivning av vad algoritmen gör.
features
 features object

Deprecated. Använd egenskapen docs i stället.
AlgorithmDocs
 docs AlgorithmDocs

Dokumentation för en bedömningsalgoritm.

AlgorithmDocs

Dokumentation för en bedömningsalgoritm.

Name Sökväg Typ Description
name
 name string
beskrivning
 description
config
 config object
features
 features object

AlgorithmResponse

Name Sökväg Typ Description
Algoritmer
 algorithms array of Algorithm
default
 default string
bäst
 best string

EntityMatchResponse

Name Sökväg Typ Description
Svaren
 responses object
matchning
 matcher object

Information om den matchning som användes för att bedöma den här begäran. Inaktuell använder du /algorithms slutpunkten i stället.
limit
 limit integer

EntityResponse

Name Sökväg Typ Description
Id-nummer
 id string
bildtext
 caption string
schema
 schema string
egenskaper
 properties object
Datauppsättningar
 datasets array of string
referenter
 referents array of string
mål
 target boolean
first_seen
 first_seen
last_seen
 last_seen
last_change
 last_change

FreebaseManifest

Name Sökväg Typ Description
versions
 versions array of string
name
 name string
identifierSpace
 identifierSpace string
schemaSpace
 schemaSpace string
dokumentation
 documentation string
batchstorlek
 batchSize integer
FreebaseManifestView
 view FreebaseManifestView
FreebaseManifestPreview
 preview FreebaseManifestPreview
FreebaseManifestSuggest
 suggest FreebaseManifestSuggest
FreebaseManifestExtend
 extend FreebaseManifestExtend
defaultTypes
 defaultTypes array of FreebaseType

FreebaseManifestExtend

Name Sökväg Typ Description
FreebaseManifestExtendProposeProperties
 propose_properties FreebaseManifestExtendProposeProperties
propose_settings
 propose_settings array of FreebaseManifestExtendPropertySetting

FreebaseManifestExtendPropertySetting

Name Sökväg Typ Description
name
 name string
label
 label string
type
 type string
default
 default
help_text
 help_text string
choices
 choices array of FreebaseManifestExtendPropertySettingChoice

FreebaseManifestExtendPropertySettingChoice

Name Sökväg Typ Description
Id-nummer
 id string
name
 name string

FreebaseManifestExtendProposeProperties

Name Sökväg Typ Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestPreview

Name Sökväg Typ Description
URL
 url string
bredd
 width integer
höjd
 height integer

FreebaseManifestSuggest

Name Sökväg Typ Description
FreebaseManifestSuggestType
 entity FreebaseManifestSuggestType
FreebaseManifestSuggestType
 type FreebaseManifestSuggestType
FreebaseManifestSuggestType
 property FreebaseManifestSuggestType

FreebaseManifestSuggestType

Name Sökväg Typ Description
service_url
 service_url string
service_path
 service_path string

FreebaseManifestView

Name Sökväg Typ Description
URL
 url string

FreebaseType

Name Sökväg Typ Description
Id-nummer
 id string
name
 name string
beskrivning
 description

SearchResponse

Name Sökväg Typ Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of EntityResponse
Aspekter
 facets object

Statement

Name Sökväg Typ Description
Id-nummer
 id string
entity_id
 entity_id string
canonical_id
 canonical_id string
stöd
 prop string
prop_type
 prop_type string
schema
 schema string
värde
 value string
original_value
 original_value
dataset
 dataset string
Språk
 lang
first_seen
 first_seen date-time
last_seen
 last_seen date-time

StatementResponse

Name Sökväg Typ Description
limit
 limit integer
offset
 offset integer
TotalSpec
 total TotalSpec
results
 results array of Statement

StatusResponse

Name Sökväg Typ Description
status
 status string

TotalSpec

Name Sökväg Typ Description
värde
 value integer
relation
 relation string

objekt

Det här är typen "objekt".