Documentación · API de verificación
La API de búsqueda
Encuentre registros por nombre y explore una colección con filtros. Está pensada para consultas e interfaces; para decisiones de verificación, utilice la coincidencia (matching).
Use la coincidencia (matching) para la verificación. La búsqueda encuentra registros que contienen las palabras que usted escribe. No les asigna una puntuación, no compara fechas de nacimiento ni países, y no tolera variantes ortográficas. Para decidir si una parte figura en una lista, utilice la API de coincidencia (matching).
Ejemplo
La colección forma parte de la ruta, igual que en la coincidencia (matching): /api/search/default, /sanctions, /peps, /crime o /maritime. /api/search por sí sola busca en todo.
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 respuesta incluye total, page, limit, offset, los filters aplicados y results. Cada resultado contiene el ID del registro, el registro de origen, el nombre y los alias, el tipo, el tipo de lista, los temas, el programa, la fecha de nacimiento, la nacionalidad, el ID de la entidad combinada y las fechas.
Parámetros
| Parámetro | Significado |
|---|---|
q | Nombre que se busca, de al menos 2 caracteres. Es opcional cuando se establece un filtro, de modo que se pueda explorar una colección. |
type | Tipo de entidad tal como se almacena: INDIVIDUAL, COMPANY, ORGANIZATION, VESSEL, AIRCRAFT. |
list_type | SANCTION, PEP, DEBARMENT, TAX_WARRANT, INSOLVENCY. |
topics | Uno o más temas de riesgo, como en match. |
include_dataset, exclude_dataset | Nombres de registros que se conservan o se excluyen, como en match. source (un solo registro) también funciona. |
nationality | Código de país de dos letras. |
dob | Prefijo de la fecha de nacimiento: YYYY, YYYY-MM o YYYY-MM-DD. |
program | Nombre exacto del programa. |
changed_since | Fecha u hora en formato ISO 8601: solo los registros agregados o modificados desde entonces. |
sort | first_seen para ver primero los registros más recientes. De lo contrario, primero los nombres exactos, luego los nombres que comienzan con la consulta y después el resto, en orden alfabético. |
limit | Resultados por página, hasta 50. Valor predeterminado: 25. |
page o offset | Número de página a partir de 1, o un desplazamiento de registros. |
Facetas
Los recuentos por tipo de lista, tipo de entidad, país y registro para la misma consulta provienen de un punto de acceso complementario, GET /api/facets, que acepta q, scope, list_type, type, nationality, source y program. Los países y los registros se limitan a los 30 principales. Consulte la referencia.
Una nota sobre privacidad
La búsqueda usa GET, por lo que el nombre que se busca forma parte de la dirección y puede aparecer en los registros de los servidores web por los que pasa la solicitud. Cuando verifique información personal, use POST /api/match, que envía la consulta en el cuerpo de la solicitud; el servicio de coincidencia (matching) no almacena los cuerpos de las solicitudes.
Cómo se encuentran los nombres
La búsqueda no tiene un lenguaje de consulta. Un registro se encuentra cuando su nombre comienza con lo que usted escribió, o cuando su nombre o un alias contiene todas las palabras que escribió, en cualquier orden. No se distingue entre mayúsculas y minúsculas.
Frases exactas
Los nombres exactos aparecen primero, seguidos de los nombres que comienzan con su texto. Las comillas no tienen ningún significado especial.
Variaciones ortográficas
La búsqueda no admite errores ortográficos ni transliteraciones. Envíe las variantes como alias a la API de coincidencia (matching), que alinea grafías cercanas.
Operadores
No se admiten operadores difusos (~), de proximidad, booleanos (AND, OR, +, -) ni de agrupación. Deben estar presentes todas las palabras.
Consultas por campo
En lugar de la sintaxis de campos dentro de q, utilice parámetros:
| Para acotar por | Uso |
|---|---|
| País | nationality=ru |
| Tema | topics=role.pep |
| Registro | include_dataset=UK%20OFSI |
| Tipo de entidad | type=VESSEL |
| Fecha de nacimiento | dob=1953 |
| Programa | program=UA%20NSDC |
| Más recientes primero | sort=first_seen |
Más información: la referencia del punto de acceso.
Última actualización 2026-10-03