Guide complet sur l’API Web of Science

Présentation de l’API Web of Science

L’API Web of Science permet d’accéder de façon programmatique à l’une des plus grandes bases de données de publications scientifiques, offrant des métadonnées détaillées, des citations, des affiliations, et des indicateurs bibliométriques. L’API propose plusieurs modules (Starter, Expanded, Journals, Reviewer Locator, etc.) selon les besoins et le niveau d’accès souscrit. L’accès nécessite une clé API fournie après inscription sur le portail développeur de Clarivate et dépend du contrat institutionnel.

Fonctionnalités principales de l’API

• Recherche avancée : par titre, auteur, sujet, DOI, institution, etc.
• Filtrage et pagination : combiner critères et parcourir de grands ensembles de résultats.
• Formats de réponse : JSON et XML, adaptés à l’intégration dans différents systèmes.
• Récupération des citations : nombre de citations, références citées, articles citant.
• Métadonnées complètes : affiliations, financement, type de document, mots-clés, etc.
• Indicateurs bibliométriques : Impact Factor, H-index, etc. (via modules spécialisés).

Bonnes pratiques et conditions d’utilisation

• L’accès à l’API nécessite une clé API et un abonnement institutionnel actif.
• Respecter les limites de requêtes (ex. : 2 requêtes/seconde, 200 requêtes/jour pour certains plans).
• Ne pas partager la clé API publiquement.
• Respecter les conditions d’utilisation de Clarivate et citer la provenance des données.
• Pour des besoins intensifs (extraction massive), contacter Clarivate pour des solutions adaptées.

Exemples d’utilisation de l’API Web of Science

Retrouvez ci-dessous trois exemples d’utilisation de l’API Web of Science dans différents langages (Python, JavaScript, R), intégrés dans des onglets Bootstrap pour une navigation fluide.

• Python
• JavaScript
• R

import requests

API_KEY = "VOTRE_CLE_API"
headers = {"X-ApiKey": API_KEY}
params = {
    "db": "WOS",
    "q": '(TS="machine learning") AND DT=Article',
    "limit": 5,
    "page": 1
}
url = "https://api.clarivate.com/api/wos"

response = requests.get(url, headers=headers, params=params)
if response.ok:
    data = response.json()
    for article in data.get("hits", []):
        print(article.get("title"))
else:
    print("Erreur :", response.status_code)

// Exemple avec fetch (Node.js ou navigateur avec proxy)
const API_KEY = "VOTRE_CLE_API";
const url = "https://api.clarivate.com/api/wos?q=(TS=%22machine%20learning%22)%20AND%20DT=Article&limit=5&page=1";

fetch(url, {
  headers: {
    "X-ApiKey": API_KEY
  }
})
.then(response => response.json())
.then(data => {
  data.hits.forEach(article => {
    console.log(article.title);
  });
})
.catch(error => console.error(error));

library(httr)
library(jsonlite)

api_key <- "VOTRE_CLE_API"
url <- "https://api.clarivate.com/api/wos"
params <- list(
  db = "WOS",
  q = '(TS="machine learning") AND DT=Article',
  limit = 5,
  page = 1
)
res <- GET(url, add_headers("X-ApiKey" = api_key), query = params)
data <- fromJSON(content(res, "text"))

titles <- sapply(data$hits, function(article) article$title)
print(titles)

Exemples de projets utilisant l’API Web of Science

• Tableau de bord de veille scientifique : Suivi en temps réel des publications sur des thématiques stratégiques pour une institution ou un laboratoire.
• Analyse bibliométrique : Extraction massive de données pour calculer des indicateurs (H-index, Impact Factor, réseaux de citations) et visualiser les tendances de la recherche.
• Intégration dans un CRIS : Connexion de l’API à un système d’information de la recherche pour enrichir automatiquement les fiches chercheurs et projets.
• Génération automatique de rapports de performance : Production de rapports périodiques sur la production scientifique d’une entité.
• Recherche de reviewers : Utilisation du module Reviewer Locator pour identifier des experts pour l’évaluation par les pairs.

Références et ressources utiles

• Documentation officielle : developer.clarivate.com/apis/wos
• Portail institutionnel : clarivate.libguides.com/c.php?g=1140539&p=10430704
• Exemples Python : github.com/clarivate/wos_api_usecases
• Exemples R : rdrr.io/github/juba/rwos/
• Tutoriel Bootstrap Tabs : getbootstrap.com/docs/5.3/components/navs-tabs/