CH03 / Vidéos libres et open data

Archives nationales américaines et Library of Congress : télécharger des films historiques

Mis à jour le Rédaction Video Downloader Info8 segments~6 min

L'essentiel

  1. Les Archives nationales américaines (NARA) et la Library of Congress (LOC) détiennent les plus grandes collections publiques de films américains, dont une grande partie est numérisée et téléchargeable.
  2. Les films produits par les agences fédérales américaines relèvent en général du domaine public, mais la NARA conserve aussi des fonds déposés avec restrictions : lisez le champ des restrictions de chaque notice.
  3. L'API Catalog v2 de la NARA exige une clé gratuite, demandée par e-mail et transmise dans l'en-tête x-api-key, avec une limite par défaut de 10 000 requêtes par mois.
  4. L'API JSON de loc.gov ne demande pas de clé : ajoutez fo=json à presque toute URL de recherche loc.gov, et utilisez /film-and-videos/ pour ne garder que les images animées.
  5. Chaque document de la Library of Congress comporte une mention Rights and Access, qui fait foi pour la réutilisation, plus que l'âge du film.
Le bâtiment des Archives nationales à Washington
Image: National Archives Building 2,Kurt Kaiser,CC0,via Wikimedia Commons.

Les deux sources primaires du film historique américain sont les Archives nationales (NARA), qui conservent les archives du gouvernement fédéral, et la Library of Congress, qui reçoit les dépôts au titre du copyright et gère des collections cinématographiques. Les deux mettent en ligne une grande partie de leurs fonds et proposent une API. Leurs règles diffèrent : l’API de la NARA exige une clé gratuite, celle de la Library of Congress non.

Ce guide explique comment interroger chaque catalogue, télécharger les fichiers et vérifier les droits avant toute réutilisation.

Quels films ces deux institutions conservent-elles ?

Institution Fonds typiques Droits en général
Archives nationales (NARA) Films produits ou collectés par les agences fédérales : images militaires, actualités filmées, films d’information, productions de la NASA et d’autres agences Œuvres fédérales en général dans le domaine public ; fonds déposés parfois restreints
Library of Congress (LOC) Cinéma des premiers temps, dépôts au titre du copyright, National Film Registry, collections données Variable, indiqué dans Rights and Access

Aux États-Unis, les œuvres du gouvernement fédéral ne sont pas protégées par le copyright (US Copyright Office, Copyright Basics) : c’est ce qui fait de la NARA une mine d’images réutilisables. La Library of Congress est différente : beaucoup de ses films y ont été déposés pour l’enregistrement du copyright, et leur statut dépend des dates, des renouvellements et des accords avec les donateurs. Notre méthode pour vérifier qu’un film est dans le domaine public détaille le raisonnement.

Attention, pour un usage en France : l’absence de copyright fédéral vaut aux États-Unis. Pour une diffusion européenne, la plupart des réutilisateurs s’appuient sur la mention de la NARA, mais le statut d’une œuvre se juge en principe selon la loi du pays où elle est exploitée.

Comment chercher dans le catalogue de la NARA ?

Commencez par l’interface web catalog.archives.gov. Filtrez sur le type de document Moving Images et sur les notices disponibles en ligne. Chaque notice indique :

  • le National Archives Identifier (NAID), l’identifiant stable à utiliser dans vos scripts ;
  • le créateur (l’agence qui a produit le film) ;
  • les restrictions d’accès et d’usage, les champs décisifs pour la réutilisation ;
  • les objets numériques joints, avec liens de téléchargement directs quand le film est numérisé.

Lisez d’abord le champ des restrictions d’usage : la valeur recherchée est « Unrestricted ».

Comment utiliser l’API Catalog de la NARA ?

L’API Catalog v2 se trouve sous https://catalog.archives.gov/api/v2/. Avant de l’utiliser :

  1. Demandez une clé en écrivant à Catalog_API@nara.gov avec votre nom et l’adresse e-mail à associer. La clé par défaut est en lecture seule.
  2. Envoyez la clé dans l’en-tête x-api-key de chaque requête.
  3. Respectez le quota : par défaut 10 000 requêtes par mois et par clé. Au-delà, la clé est bloquée jusqu’au premier jour du mois suivant.

La page officielle de démarrage montre une recherche par mot-clé sur le point d’accès records/search, filtrable par disponibilité en ligne et par type de document :

curl -s -H "x-api-key: VOTRE_CLE" \
  "https://catalog.archives.gov/api/v2/records/search?q=project%20blue%20book&availableOnline=true&typeOfMaterials=Sound%20Recordings"

Pour les films, utilisez typeOfMaterials=Moving%20Images :

curl -s -H "x-api-key: VOTRE_CLE" \
  "https://catalog.archives.gov/api/v2/records/search?q=apollo&availableOnline=true&typeOfMaterials=Moving%20Images&limit=100&page=1"

La spécification Swagger de l’API (catalog.archives.gov/api/v2/swagger.json, consultable sur catalog.archives.gov/api/v2/api-docs/) fait référence. Voici les paramètres de records/search les plus utiles pour la vidéo :

Paramètre Rôle
q Recherche par mots-clés ; accepte opérateurs booléens, jokers et expressions entre guillemets
typeOfMaterials Type de document ; valeurs acceptées notamment Moving Images, Sound Recordings, Photographs and other Graphic Materials et Textual Records
availableOnline true ne garde que les notices numérisées
recordGroupNumber Limite à un groupe d’archives (record group), l’unité qui regroupe les fonds de chaque administration
startDate, endDate Période
page, limit Pagination

Les résultats contiennent le NAID et les objets numériques, d’où vous tirerez les URL de téléchargement. Le filtre par groupe d’archives est particulièrement efficace pour le film : les bobines d’une administration sont classées avec ses fonds, si bien que connaître le groupe de la NASA ou du Signal Corps réduit des milliers de résultats aux seules bobines pertinentes.

Le quota mensuel étant modeste, cherchez une fois, enregistrez les résultats en JSON, puis téléchargez à partir de cette liste plutôt que de répéter les requêtes.

Les pièges à éviter avec l’API de la NARA :

  • Appeler l’API sans clé. Sans l’en-tête x-api-key, vous ne recevez pas une erreur JSON exploitable mais la page web du catalogue. Si jq échoue sur la réponse, vérifiez d’abord l’en-tête.
  • Oublier availableOnline=true. Beaucoup de notices de films décrivent des bobines qui n’existent que sur support physique : sans ce filtre, la plupart des résultats n’ont rien à télécharger.
  • Gaspiller le quota en pagination. Demandez la plus grande valeur de limit que votre traitement supporte, pour ramener plus de notices par requête.
  • Se fier au seul titre. Lisez les restrictions d’usage de chaque notice conservée : quelques films d’une série gouvernementale contiennent des éléments de tiers.

Comment interroger la Library of Congress avec l’API loc.gov ?

L’API loc.gov est intégrée au site : ajoutez fo=json à presque toute URL loc.gov et vous obtenez du JSON au lieu du HTML. Pour les images animées, utilisez le point d’accès film-and-videos :

curl -s "https://www.loc.gov/film-and-videos/?q=edison&fo=json&c=25&sp=1"
  • q : recherche dans les métadonnées et, quand il existe, le texte intégral, y compris les transcriptions vidéo ;
  • fo=json : format de réponse (yaml fonctionne aussi) ;
  • c : nombre de résultats par page (25 par défaut) ;
  • sp : numéro de page, à partir de 1 ;
  • fa : filtre de facette, sous la forme nom:valeur.

Pas de clé, mais la Library of Congress applique des limites de débit et bloque les clients qui la surchargent. La pagination au-delà du 100 000e résultat n’est pas prise en charge : découpez les grosses requêtes avec des facettes. Dans un script, marquez une pause entre les requêtes :

for page in 1 2 3; do
  curl -s "https://www.loc.gov/film-and-videos/?q=edison&fo=json&c=25&sp=$page" -o "loc-edison-$page.json"
  sleep 3
done

Comment télécharger un film de la Library of Congress ?

Chaque page de document sur loc.gov propose un menu de téléchargement avec les versions de fichier disponibles. Dans le JSON d’un document, les mêmes fichiers figurent parmi ses ressources. Pour la recherche ou le montage, prenez la meilleure qualité proposée et conservez l’URL du document avec le fichier.

Avant toute réutilisation, lisez la rubrique Rights and Access de la page. La Library la rédige par collection ou par document, et elle est plus fiable qu’une déduction fondée sur l’année de sortie. Certaines collections sont décrites comme du domaine public ou sans restriction connue ; d’autres mentionnent un copyright ou des conditions du donateur.

Peut-on obtenir une meilleure qualité ?

Les fichiers en ligne sont souvent des copies de consultation. La salle de recherche Motion Picture, Sound and Video de la NARA, à College Park (Maryland), conserve les originaux, et la NARA explique sur ses pages consacrées au film comment commander des reproductions. C’est utile pour un producteur de documentaire qui a besoin d’une qualité de diffusion plutôt que d’un fichier web.

Comment classer et citer ce que l’on télécharge ?

Mettez l’identifiant de la notice dans le nom du fichier et enregistrez le JSON de la notice à côté de la vidéo :

NAID-12345678_images-brutes-alunissage.mp4
NAID-12345678.json

Créditez l’institution et la notice, par exemple « National Archives, NAID 12345678 ». Si vous travaillez sur une enquête ou devez prouver l’origine d’un fichier, notre guide de préservation vidéo pour l’OSINT explique comment calculer une empreinte et documenter la provenance.

Quelles autres sources ouvertes complètent la NARA et la LOC ?

Beaucoup de films de la NARA se retrouvent sur Internet Archive et Wikimedia Commons, parfois mieux décrits, parfois en moins bonne qualité. Pour les images spatiales, la vidéothèque de la NASA est la source directe. Pour le patrimoine européen, voyez Europeana.

Outils open source de ce guide

OutilLicence
curlLicence curl (type MIT)
jqMIT

Questions fréquentes

Les films des Archives nationales américaines sont-ils dans le domaine public ?

Les films produits par des agences fédérales, comme l'armée, la NASA ou le ministère de l'Agriculture, ne sont en général pas protégés par le copyright aux États-Unis. La NARA conserve aussi des films déposés ou commerciaux, dont des actualités filmées, qui peuvent comporter des restrictions. Vérifiez les restrictions d'usage de chaque notice.

Comment obtenir une clé pour l'API Catalog de la NARA ?

Écrivez à Catalog_API@nara.gov en indiquant votre nom et l'adresse e-mail à associer à la clé. La clé par défaut est en lecture seule et permet 10 000 requêtes par mois ; une limite plus élevée peut être demandée par e-mail.

L'API de la Library of Congress exige-t-elle une clé ?

Non. L'API JSON de loc.gov est publique et sans clé, mais elle applique des limites de débit et bloque les clients trop insistants. La pagination au-delà du 100 000e résultat n'est pas prise en charge : affinez les grosses requêtes avec des facettes.

Peut-on commander une meilleure copie que le fichier en ligne ?

Oui. La section Motion Picture de la NARA explique comment commander des reproductions de films non numérisés ou en meilleure qualité. Tarifs et délais sont fixés par la NARA et évoluent : consultez la page de commande.

Les vieux films de loc.gov sont-ils tous réutilisables ?

Non. La Library of Congress indique les droits document par document dans la rubrique Rights and Access. Certaines collections sont dans le domaine public ou sans restriction connue, d'autres restent protégées ou soumises à des conditions du donateur.

Sources et données ouvertes

  1. API for the National Archives Catalog · US National Archives
  2. Catalog API getting started · US National Archives
  3. Documentation Swagger de l'API Catalog v2 · US National Archives
  4. Moving Image and Sound Holdings · US National Archives
  5. loc.gov JSON/YAML API · Library of Congress
  6. Paramètres de requête de l'API loc.gov · Library of Congress
  7. Copyright Basics, Circular 1 · US Copyright Office