Inicio rápido de la API de coincidencias

Verifique a una persona contra todas las listas en una sola solicitud y luego siga el resultado hasta el registro completo.

La API de coincidencias funciona por ejemplos: usted describe a la parte que desea comprobar y la API devuelve los registros que se parecen a esa descripción, comenzando por los mejores. Puede ejecutar la misma comprobación con un formulario en Verificación.

Antes de comenzar. Hoy no se necesita ninguna clave. Utilice la API conforme a nuestros términos de uso; la verificación dentro de un proceso empresarial requiere una licencia comercial.

Su primera solicitud

Envíe una consulta, q1, que describa a una persona por nombre, año de nacimiento y nacionalidad, a la colección default:

curl -X POST "https://api.crownintelligence.net/api/match/default?limit=3" \
  -H "Content-Type: application/json" \
  -d '{"queries":{"q1":{"schema":"Person","properties":{"name":["Igor Putin"],"birthDate":["1953"],"nationality":["ru"]}}}}'

import requests

BASE = "https://api.crownintelligence.net"
query = {
    "schema": "Person",
    "properties": {"name": ["Igor Putin"], "birthDate": ["1953"], "nationality": ["ru"]},
}
r = requests.post(f"{BASE}/api/match/default", params={"limit": 3}, json={"queries": {"q1": query}}, timeout=60)
r.raise_for_status()
for hit in r.json()["responses"]["q1"]["results"]:
    print(hit["score"], hit["match"], hit["caption"], hit["datasets"], hit["id"])

const BASE = "https://api.crownintelligence.net";
const res = await fetch(`${BASE}/api/match/default?limit=3`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ queries: { q1: { schema: "Person",
    properties: { name: ["Igor Putin"], birthDate: ["1953"], nationality: ["ru"] } } } }),
});
const data = await res.json();
for (const hit of data.responses.q1.results) console.log(hit.score, hit.match, hit.caption, hit.datasets, hit.id);

{"queries":{"q1":{"schema":"Person","properties":{"name":["Igor Putin"],"birthDate":["1953"],"nationality":["ru"]}}}}

Utilice una lista para cada propiedad: una parte puede tener varios nombres, fechas de nacimiento o nacionalidades. Encontrará más información sobre cómo redactar consultas en La solicitud.

Cómo leer la respuesta

La respuesta contiene una entrada en responses por cada consulta enviada. Un ejemplo abreviado:

{
  "collection": "default",
  "algorithm": "standard",
  "threshold": 0.75,
  "limit": 3,
  "responses": {
    "q1": {
      "status": 200,
      "query": {
        "schema": "Person",
        "name": [
          "Igor Putin"
        ],
        "birthDate": [
          "1953"
        ],
        "nationality": [
          "ru"
        ],
        "imo": []
      },
      "total": 1503,
      "results": [
        {
          "id": 379937151,
          "caption": "PUTIN IGOR ALEXANDROVICH",
          "schema": "Person",
          "score": 1,
          "match": true,
          "features": [
            {
              "feature": "name_match",
              "explanation": "'IGOR'≈'IGOR' exact 1.00 · 'PUTIN'≈'PUTIN' exact 1.00 · 'ALEXANDROVICH' not in query",
              "score": 0.9
            },
            {
              "feature": "dob_match",
              "explanation": "query 1953 · record 1953-03-30 · match",
              "score": 0.1
            }
          ],
          "datasets": [
            "ACF War Enablers — Anti-Corruption Foundation list"
          ],
          "topics": [
            "debarment"
          ],
          "programme": "Individuals involved in corruption",
          "merged_entity": "ce7e35f9-f4b5-4d30-95f0-ab7385538b78",
          "url": "/estate/record.html?id=379937151"
        }
      ]
    }
  },
  "checked_at": "2026-10-04T01:38:23.856Z"
}

id identifica el registro. Guárdelo junto con su decisión y utilícelo con la API de entidades.
score va de 0 a 1 y match es verdadero cuando la puntuación alcanza el umbral. Una puntuación mide el parecido, no el riesgo.
features explican la puntuación: qué palabras coincidieron y si la fecha de nacimiento, el país, el número IMO y el tipo de entidad concordaron.
topics, datasets y programme indican por qué es relevante el registro: qué tipo de lista, qué registro y qué programa.
merged_entity aparece cuando la misma parte figura en varios registros.

Cada registro es la entrada de un registro determinado, por lo que la misma parte puede devolverse varias veces desde registros distintos. Detalle campo por campo: La respuesta.

Para ir más allá: el punto de acceso de entidades

Los resultados de coincidencias se mantienen breves. Para ver un registro completo, con sus inclusiones en listas y los demás registros que nombran a la misma parte, consúltelo en la API de entidades:

curl "https://api.crownintelligence.net/api/entity/379781867"

import requests

BASE = "https://api.crownintelligence.net"
record = requests.get(f"{BASE}/api/entity/379781867", timeout=60).json()
for listing in record["listings"]:
    print(listing["register"], listing["programme"], listing["list_type"])
if record.get("entity_id"):
    merged = requests.get(f"https://api.crownintelligence.net/api/entity/{record['entity_id']}", timeout=60).json()
    print(merged["caption"], merged["datasets"], merged["properties"]["birthDate"])

Cada registro también tiene una página en este sitio, enlazada mediante url en el resultado, por ejemplo registro 379781867.

Última actualización 2026-10-03