Documentation · API de vérification

L’API de recherche

Trouvez des fiches par nom et parcourez une collection à l’aide de filtres. Conçue pour les consultations et les interfaces; pour les décisions de vérification, utilisez la mise en correspondance.

Utilisez la mise en correspondance pour la vérification. La recherche trouve les fiches qui contiennent les mots saisis. Elle ne les évalue pas, ne compare ni les dates de naissance ni les pays, et ne tolère pas les variantes d’orthographe. Pour déterminer si une partie figure sur une liste, utilisez l’API de mise en correspondance.

Exemple

La collection fait partie du chemin, comme pour la mise en correspondance : /api/search/default, /sanctions, /peps, /crime ou /maritime. /api/search seul recherche dans l’ensemble des collections.

curl "https://api.crownintelligence.net/api/search/sanctions?q=putin&nationality=ru&limit=10"
import requests

BASE = "https://api.crownintelligence.net"
r = requests.get(f"{BASE}/api/search/sanctions", params={"q": "putin", "nationality": "ru", "limit": 10}, timeout=60)
data = r.json()
print(data["total"], "records")
for rec in data["results"]:
    print(rec["id"], rec["name"], rec["register"], rec["topics"])
const BASE = "https://api.crownintelligence.net";
const url = new URL(`${BASE}/api/search/sanctions`);
url.search = new URLSearchParams({ q: "putin", nationality: "ru", limit: "10" });
const data = await (await fetch(url)).json();
console.log(data.total, data.results.map(r => r.name));

La réponse contient total, page, limit, offset, le filters appliqué et results. Chaque résultat comprend l’ID de la fiche, le registre, le nom et les alias, le type, le type de liste, les sujets, le programme, la date de naissance, la nationalité, l’ID de l’entité fusionnée et les dates.

Paramètres

ParamètreSignification
qNom à rechercher, d’au moins 2 caractères. Facultatif lorsqu’un filtre est défini, ce qui permet de parcourir une collection.
typeType d’entité tel qu’il est enregistré : INDIVIDUAL, COMPANY, ORGANIZATION, VESSEL, AIRCRAFT.
list_typeSANCTION, PEP, DEBARMENT, TAX_WARRANT, INSOLVENCY.
topicsUn ou plusieurs sujets de risque, comme pour la mise en correspondance.
include_dataset, exclude_datasetNoms de registres à conserver ou à exclure, comme pour la mise en correspondance. source (un seul registre) fonctionne aussi.
nationalityCode de pays à deux lettres.
dobPréfixe de date de naissance : YYYY, YYYY-MM ou YYYY-MM-DD.
programNom exact du programme.
changed_sinceDate ou heure ISO 8601 : seules les fiches ajoutées ou modifiées depuis ce moment sont retournées.
sortfirst_seen pour obtenir les fiches les plus récentes en premier. Sinon, les noms exacts viennent en premier, puis les noms qui commencent par la requête, puis le reste, par ordre alphabétique.
limitNombre de résultats par page, jusqu’à 50. Valeur par défaut : 25.
page ou offsetNuméro de page à partir de 1, ou décalage de fiches.

Facettes

Les dénombrements par type de liste, type d’entité, pays et registre pour la même requête proviennent d’un point d’accès complémentaire, GET /api/facets, qui accepte q, scope, list_type, type, nationality, source et program. Les pays et les registres sont limités aux 30 premiers. Consultez la référence.

Remarque sur la confidentialité

La recherche utilise GET; le nom recherché fait donc partie de l’adresse et peut figurer dans les journaux des serveurs web en cours de route. Lorsque vous effectuez la vérification de renseignements personnels, utilisez POST /api/match, qui transmet la requête dans le corps de la requête; le service de mise en correspondance ne conserve pas les corps de requête.

Comment les noms sont trouvés

La recherche n’a pas de langage de requête. Une fiche est trouvée lorsque son nom commence par le texte saisi, ou lorsque son nom ou un alias contient tous les mots saisis, dans n’importe quel ordre. La casse est ignorée.

Expressions exactes

Les noms exacts sont classés en premier, puis les noms qui commencent par votre texte. Les guillemets n’ont aucune signification particulière.

Variantes d’orthographe

La recherche ne tient pas compte des fautes d’orthographe ni des translittérations. Envoyez les variantes sous forme d’alias à l’API de mise en correspondance, qui rapproche les orthographes similaires.

Opérateurs

Les opérateurs de recherche approximative (~), de proximité, booléens (AND, OR, +, -) et de regroupement ne sont pas pris en charge. Chaque mot doit être présent.

Requêtes par champ

Au lieu de la syntaxe par champ dans q, utilisez des paramètres :

Pour restreindre parUtilité
Paysnationality=ru
Sujettopics=role.pep
Registreinclude_dataset=UK%20OFSI
Type d’entitétype=VESSEL
Date de naissancedob=1953
Programmeprogram=UA%20NSDC
Plus récents en premiersort=first_seen

Pour en savoir plus : la référence du point d’accès.

Dernière mise à jour : 2026-10-03