Introduction

Unpaywall REST API permet d’accéder librement à plus de 40 millions d’articles scientifiques en texte intégral, légalement disponibles en open access. Grâce à cette API, il est possible d’enrichir vos applications, portails ou outils de veille avec des liens directs vers des versions gratuites d’articles, à partir de leur DOI.

Fonctionnalités Clés

• Recherche d’accès libre à partir d’un DOI (Digital Object Identifier).
• Retour d’informations sur le statut open access, la licence, l’URL du PDF, la version, etc.
• API RESTful, rapide et sans authentification obligatoire (juste un e-mail recommandé).
• Utilisation gratuite pour la recherche, l’intégration web, les bibliothèques et les outils d’analyse.

Structure de l’API

Principaux Paramètres

• doi : identifiant de l’article scientifique
• email : adresse e-mail de contact (recommandée pour l’usage intensif)

Exemples d’Implémentation

• Requête cURL
• Python
• JavaScript (fetch)

# Vérifier l’accès libre d’un article par DOI
curl "https://api.unpaywall.org/v2/10.1038/nature12373?email=youremail@example.com"
                

import requests

doi = "10.1038/nature12373"
email = "youremail@example.com"
url = f"https://api.unpaywall.org/v2/{doi}?email={email}"

response = requests.get(url)
if response.status_code == 200:
    data = response.json()
    print("Titre :", data["title"])
    print("OA URL :", data["best_oa_location"]["url"])
else:
    print("Erreur:", response.status_code)
                

// Vérifier si un article est en open access avec fetch
fetch("https://api.unpaywall.org/v2/10.1038/nature12373?email=youremail@example.com")
  .then(res => res.json())
  .then(data => {
    console.log("Titre :", data.title);
    console.log("OA URL :", data.best_oa_location ? data.best_oa_location.url : "Non disponible");
  });
                

Bonnes Pratiques

• Inclure systématiquement votre adresse e-mail dans les requêtes (?email=...).
• Limiter la fréquence des requêtes pour éviter tout blocage (max. 100 000 requêtes/jour).
• Respecter les conditions d’utilisation et la légalité de l’accès aux contenus.
• Consulter la documentation officielle pour les dernières évolutions.

Conclusion

L’API Unpaywall est un outil incontournable pour démocratiser l’accès à la science ouverte. Simple, rapide et gratuite, elle permet d’intégrer facilement la détection et l’accès aux versions libres des articles scientifiques dans tous vos projets numériques.