Documentation · Données en bloc

Fichiers delta

Au lieu de télécharger une collection entière après chaque version, vous pouvez appliquer uniquement ce qui a changé. Chaque version publie les fiches ajoutées, modifiées et supprimées depuis la version précédente.

Les fichiers en bloc se téléchargent gratuitement, sans compte. L’utilisation non commerciale est couverte par notre licence de données; l’utilisation commerciale exige une licence. Pour vérifier des noms un à un, utilisez plutôt l’API de vérification.

Les deltas couvrent les entités FollowTheMoney de entities.ftm.json (les fiches répertoriées, et non leurs entités Sanction). Il n’existe pas de deltas pour les fichiers CSV, de noms ou Senzing; reconstruisez-les à partir de vos entités mises à jour, ou téléchargez-les de nouveau.

Qu’est-ce qu’un delta?

À chaque version, nous calculons une empreinte de chaque fiche : le SHA-1 de sa ligne JSON complète. La comparaison avec l’empreinte de la version précédente donne trois types de changement :

Un changement ne provient pas toujours de la source. Une fiche est également marquée MOD lorsque notre propre traitement la modifie, par exemple une correction du type d’entité, une nouvelle fusion (canonical_id) ou une nouvelle date de confirmation (last_seen). Une fiche peut quitter une collection parce que son éditeur l’a retirée, ou parce que son registre n’est plus autorisé à la redistribution.

Comment utiliser les deltas

1. Téléchargez la collection complète une fois et notez sa version à partir de index.json.
2. Par la suite, lisez le deltas.json de la collection, qui énumère les versions récentes de la plus ancienne à la plus récente.
3. Prenez chaque version postérieure à la vôtre, dans l’ordre, et appliquez son fichier delta. Les versions sans changement ont "url": null; ignorez-les.
4. Conservez la dernière version appliquée, puis recommencez.

Si votre version est antérieure à la première entrée de deltas.json (nous conservons les 30 dernières versions), la chaîne est rompue : téléchargez de nouveau la collection complète.

/downloads/collections/<collection>/index.json     version of the current build
/downloads/collections/<collection>/deltas.json    recent builds, oldest first
/downloads/collections/<collection>/delta.json     changes in the current build only

Une entrée de deltas.json :

{
  "scope": "sanctions",
  "keep": 30,
  "versions": [
    {
      "version": "20261004012811-k2p",
      "previous_version": "20261003174737-un0",
      "generated_at": "2026-10-04T01:28:11.000Z",
      "added": 12,
      "modified": 40,
      "removed": 3,
      "url": "/downloads/collections/sanctions/deltas/20261004012811-k2p.json",
      "bytes": 48213,
      "sha256": "…"
    }
  ],
  "oldest_version": "20261004012811-k2p",
  "latest_version": "20261004012811-k2p"
}

Les valeurs ci-dessus illustrent la structure; ce ne sont pas des chiffres réels. La liste à jour figure ci-dessous.

Versions récentes

Tant que le registre n’est pas actualisé, les versions ne détectent aucun changement et ne publient aucun fichier delta. Consultez l’actualité des données pour savoir quand les données ont été traitées pour la dernière fois.

Comprendre les fichiers delta

Un fichier delta est au format JSON lines : une opération par ligne, chacune avec op et entity. ADD et MOD contiennent l’entité complète, telle qu’elle apparaît dans entities.ftm.json; DEL ne contient que l’identifiant.

{"op":"ADD","entity":{"id":"crown-380054154","caption":"PELIKAN","schema":"Vessel","properties":{…},"datasets":["paris_mou_banned"],…}}
{"op":"MOD","entity":{"id":"crown-379700342","caption":"CHIRURGUL","schema":"Person","properties":{…},…}}
{"op":"DEL","entity":{"id":"crown-378468435"}}

import json

def apply_delta(store: dict, path: str):
    """store maps record id -> entity"""
    with open(path, encoding="utf-8") as f:
        for line in f:
            change = json.loads(line)
            entity = change["entity"]
            if change["op"] == "DEL":
                store.pop(entity["id"], None)
            else:  # ADD or MOD: replace in full
                store[entity["id"]] = entity

Fusions et changements d’identifiant

L’identifiant d’une fiche (crown-<number>) correspond à une ligne d’un registre; la fusion de fiches ne le modifie pas. Une fusion se manifeste par des opérations MOD qui ajoutent ou modifient canonical_id sur chaque fiche concernée, et une scission le supprime ou le modifie. Si vous regroupez les fiches par canonical_id, regroupez de nouveau les fiches nommées dans chaque MOD. Si un éditeur republie une inscription sous une nouvelle référence, attendez-vous à une opération DEL pour l’ancienne fiche et à une opération ADD pour la nouvelle. Voir identifiants et déduplication.

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