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ètre | Signification |
|---|---|
q | Nom à rechercher, d’au moins 2 caractères. Facultatif lorsqu’un filtre est défini, ce qui permet de parcourir une collection. |
type | Type d’entité tel qu’il est enregistré : INDIVIDUAL, COMPANY, ORGANIZATION, VESSEL, AIRCRAFT. |
list_type | SANCTION, PEP, DEBARMENT, TAX_WARRANT, INSOLVENCY. |
topics | Un ou plusieurs sujets de risque, comme pour la mise en correspondance. |
include_dataset, exclude_dataset | Noms de registres à conserver ou à exclure, comme pour la mise en correspondance. source (un seul registre) fonctionne aussi. |
nationality | Code de pays à deux lettres. |
dob | Préfixe de date de naissance : YYYY, YYYY-MM ou YYYY-MM-DD. |
program | Nom exact du programme. |
changed_since | Date ou heure ISO 8601 : seules les fiches ajoutées ou modifiées depuis ce moment sont retournées. |
sort | first_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. |
limit | Nombre de résultats par page, jusqu’à 50. Valeur par défaut : 25. |
page ou offset | Numé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 par | Utilité |
|---|---|
| Pays | nationality=ru |
| Sujet | topics=role.pep |
| Registre | include_dataset=UK%20OFSI |
| Type d’entité | type=VESSEL |
| Date de naissance | dob=1953 |
| Programme | program=UA%20NSDC |
| Plus récents en premier | sort=first_seen |
Pour en savoir plus : la référence du point d’accès.
Dernière mise à jour : 2026-10-03