Fonction "Extract"

Il s'agit d'une fonction du moteur de recherche de l'API Istex permettant d’extraire sous forme d’une archive zip le corpus correspondant à des critères de recherche. Elle s’utilise directement dans l’URL de requêtage sur l’API en la paramétrant selon ses besoins.

Avantages :

• simple à utiliser, cette fonction ne nécessite aucune installation
• elle peut être utilisée en dehors du réseau interne de l'Inist-CNRS, la gestion de l’authentification s’opérant via la fédération d’identité ou par adresse IP
• elle permet l'extraction des enrichissements lorsqu'ils existent
• elle offre le téléchargement des annexes et couvertures disponibles
• les documents extraits peuvent être répartis ou non dans une arborescence selon le choix retenu
• il est possible de réduire la taille du corpus à télécharger (paramètre size)
• si la taille du corpus extrait est réduite, on peut choisir un autre mode de tri que celui par pertinence effectué par le moteur de recherche, c’est-à-dire un tri des documents en fonction de certain champs (paramètre sortBy), ou selon un tri aléatoire (paramètre rankBy=random) avec la possibilité de retrouver cet ordre aléatoire (paramètre randomSeed) ou bien encore selon un tri utilisant un score relevé par la qualité (paramètre rankBy=qualityOverRelevance)

Mode d'emploi :

• cette fonction, ainsi que la syntaxe requise pour son utilisation et les différents paramètres disponibles, sont décrits dans la rubrique "Extraction" de la documentation technique Istex

Astuces :

• la fonction extract utilisée seule génère l’extraction de l’ensemble des fichiers disponibles pour les documents Istex du corpus.
  • Exemple : moissonnage de tous les fichiers disponibles pour un document identifié par un ARK donné : https://api.istex.fr/document/?q=ark:"ark:/67375/HXZ-7R7P2T8X-6"&extract
• la fonction extract, suivie par le signe "=" et une valeur quelconque, génère uniquement l’extraction du fichier de métadonnées au format JSON
• sans indication de format, tous les formats proposés pour le type de fichier indiqué seront extraits
• sans précision du paramètre size, 5 documents seront extraits par défaut. Pour extraire tous les documents répondant à une requête donnée, indiquer une taille de corpus au moins égale au nombre maximal de documents à extraire
  • Exemple : moissonnage du texte intégral, au format PDF, des 20 documents comportant le terme « Groenland » dans leurs titres : https://api.istex.fr/document/?q=title:groenland&size=25&extract=fulltext[pdf]