API Mir@bel (revues)

APINational · FranceNo auth

Le réseau Mir\@bel, piloté par Sciences Po Lyon et un ensemble de partenaires, a pour objectif de valoriser les contenus des périodiques scientifiques accessibles en ligne. ### A quoi sert l'API Mir\@bel ? L'API Mir\@bel référence plus de 20,000 revues scientifiques. Elle permet de consulter les…

waterland

Trust score

How is this computed?

good

Composite of 5 axes from our methodology (proof-based officialness, live verification, metadata completeness, license clarity, agent readiness).

Officialnessweight 25%40/100
40/100 from 5 proof signals (domain / portal-backlink / GitHub-org / reciprocal / policy).
Availabilityweight 25%100/100
Latest verification succeeded.
Metadata completenessweight 20%80/100
8 of 10 recommended metadata fields populated.
License clarityweight 15%50/100
License info not yet tracked for APIs (datasets only).
Agent readinessweight 15%85/100
OpenAPI spec URL declared · Spec format known (openapi) · Docs URL present · Homepage URL present · Topic tags assigned

Official Proof

Public Sector API

Proof Evidence

official domain (data.gouv.fr) (catalog: api_gouv_fr)

Data schema (84 fields)

Filterable via the API (16)

issnpartenairerevueidsudocworldcatactifidabonnementpossessiontitreidrefgrappeidoffsetthemeiddepuisressourceid

Field	Type	Description
issn	string	Numéro ISSN (ou ISSN-e) de la forme XXXX-XXXX. Le tiret et la clé sont facultatifs. On peut sélectionner plusieurs revues en séparant des ISSN par ",".
partenaire	string	Clé privée du partenaire (activable sur la page d'administration du partenaire dans Mir@bel). Si ce paramètre est fourni, les accès en ligne pourront avoir une diffusion "abonné" au lieu de "restreint". En cas d'interrogation au compte-goutte (par "id" ou "issn"), ce champ "partenaire" accepte aus
revueid	integer	Identifiant numérique de la revue dans Mir@bel. On peut sélectionner plusieurs revues (au plus 200) en séparant ces identifiants par ",". Par exemple, "revueid=3,4".
sudoc	string	Identifiant PPN de SUDOC.
worldcat	integer	Identifiant numérique de Worldcat.
actif	boolean	Restreindre aux titres actifs. Autrement dit, exclure les anciens titres des revues, ceux qui ont des successeurs.
id	integer	Identifiant numérique du titre dans Mir@bel. Il est aussi possible de donner une liste de nombres (au plus 200) séparés par des virgules, par exemple [id=14,72,1044](/api/acces/titres?id=14,72,1044) pour sélectionner les accès de ces trois titres.
abonnement	boolean	Restreint la liste aux titres auxquels le partenaire est abonné, via une collection ou une ressource. Les critères "abonnement" et "possession" sont cumulables (OU logique).
possession	boolean	Si possession=1, seuls les titres possédés par le partenaire seront concernés. Les critères "abonnement" et "possession" sont cumulables (OU logique).
titre	string	Titre. Le préfixe sera ignoré ("Monde" ou "Le Monde" donne le même résultat). Une recherche en début ("Monde%") ou milieu de titre ("%monde%") est possible. Une recherche exacte portera aussi sur le sigle des titres (par exemple, "titre=AJDA").
idref	string	Identifiant IdRef de l'éditeur, de type PPN (8 chiffres suivis d'un chiffre ou de "X").
grappeid	integer	Identifiant numérique d'une grappe. Certaines grappes sont soumises à autorisation et ne seront accessibles que si le partenaire est authentifié.
offset	integer	Les réponses sont limitées à 1000 titres. Si cette limite est atteinte, ce paramètre permet de demander la suite avec `offset=1000` etc.
themeid	integer	Identifiant numérique d'un thème. La thématique complète de Mir@bel, avec ces identifiants, est accessible par `/themes`.
depuis	string	Timestamp (en secondes) à partir duquel lister les changements. Une date textuelle ("2019-01-20 12:30:00" ou "-1 week") est aussi possible, mais plus ambiguë.
ressourceid	integer	Identifiant numérique d'une ressource (alias plate-forme) attribué par Mir@bel (par ex. `3` pour Cairn.info). Filtre supplémentaire
contenuAcces	string	Parmi "Intégral", "Résumé", "Sommaire", "Indexation".
collectionsAcces	array<object>	Liste des collections, dans la ressource de cet accès, qui contiennent cet accès. Chaque élément de la liste est un objet avec l'identifiant numérique (interne à Mir@bel) et le nom.
datedebutAcces	string	Date (YYYY ou YYYY-mm ou YYYY-mm-dd) de début d'accès.
datefinAcces	string	Éventuelle date (YYYY ou YYYY-mm ou YYYY-mm-dd) de fin d'accès.
dateinfoAcces	string	Description textuelle de la date barrière. Si cette donnée n'est pas fournie par la source de l'accès, elle est déduite du champ 'embargoinfo'. Exemple de valeur : "Accès avant une date barrière mobile de 3 années calendaires".
dernumurlAcces	string	URL pointant sur le dernier numéro de la revue.
diffusionAcces	string	Valeur parmi "libre", "restreint", "abonné". Cette dernière valeur n'est possible que si le paramètre "partenaire" est présent.
embargoinfoAcces	string	Le contenu du champ `embargo_info`, si l'accès a été créé par un import KBART.
identifiantpartenaireAcces	string	Si interrogation sur les possessions d'un partenaire, donne l'identifiant de possession.
lacunaireAcces	boolean	Si vrai, des numéros sont manquants sur la période, donc la couverture n'est pas exhaustive.
mailurlAcces	string	URL de la revue par alerte courriel.
nodebutAcces	integer	Null si le numéro est inconnu, sinon plus ancien numéro de l'accès en ligne, par exemple 6.
nofinAcces	integer	Null ou plus récent numéro de l'accès en ligne, par exemple 12.
numerodebutAcces	string	Intitulé du numéro initial, par exemple "Vol. I, no 6".
numerofinAcces	string	Intitulé du numéro final, par exemple "Vol. XXV, no 12 (HS)".
ressourceAcces	string	Nom de la ressource (alias plate-forme) fournissant cet accès.
ressourcesigleAcces	string	Nom bref (sigle ou acronyme) de la ressource.
rssurlAcces	string	URL du flux RSS de la revue.
selectionAcces	boolean	Si vrai, un numéro est représenté par une sélection d'articles, donc la couverture n'est pas exhaustive.
titreidAcces	integer	référence à Titre.id
urlAcces	string	URL de la revue.
urlproxyAcces	string	Si le partenaire est déclaré et que ses proxys sont actifs pour cet accès, alors ce champ contient l'URL avec application des proxys. Sinon, ce champ n'est pas présent.
voldebutAcces	integer	Null, ou volume initial, par exemple 1.
volfinAcces	integer	Null, ou volume final, par exemple 25.
creationsAccesChanges	array<object>	Liste des accès ajoutés.
modificationsAccesChanges	array<object>	—
suppressionsAccesChanges	array<integer>	Identifiants (cf Acces.id) des accès supprimés.
identifiantsEditeur	array<string>	Liste d'identifiants sous forme de couples [clé, valeur], par exemple `[["idref", "029524989"]]`. Clés possibles : "idref", "ror", "open policy finder".
liensEditeur	array<string>	Liste d'URL extérieures (DOAJ, etc) pour cet éditeur.
nomEditeur	string	Nom (sans son éventuel préfixe comme "L'").
paysEditeur	string	Codes ISO à 3 lettres du pays de l'éditeur.
prefixeEditeur	string	Préfixe du nom de l'éditeur (par exemple "L'").
roleEditeur	string	Rôle général de l'éditeur pour ses titres.
url_mirabelEditeur	string	Page web de cet éditeur sur le site de Mir@bel.
editeurEditeurTitre	string	Nom de l'éditeur (sans son éventuel préfixe comme "L'").
editeur_idEditeurTitre	integer	Identifiant unique attribué par Mir@bel à cet éditeur.
precedentEditeurTitre	boolean	Il s'agit d'un éditeur précédent, qui n'intervient plus sur ce titre.
titre_idEditeurTitre	integer	Identifiant unique attribué par Mir@bel à ce titre.
bnfarkIssn	string	Identifiant Ark de la BNF.
issnlIssn	string	Éventuellemnt absent.
statutIssn	string	Valeur parmi "en cours", "sans", "valide"
sudocnoholdingIssn	boolean	Si true, la notice du Sudoc n'est pas localisée.
sudocppnIssn	string	Identifiant PPN du Sudoc.
supportIssn	string	Valeur parmi "inconnu", "papier", "electronique"
worldcatocnIssn	integer	Identifiant OCN de Worldcat.
dermodifRevue	integer	Timestamp (secondes) de la dernière modification de la revue (incluant titres et accès).
derverifRevue	integer	Timestamp (secondes) de la dernière vérification des données de la revue (incluant titres et accès) dans Mir@bel.
titresRevue	array<object>	Historique des titres de la revue, triés du plus récent au plus ancien. Le premier est donc le titre actif.
parentidTheme	integer	Identifiant du thème parent. 0 pour la racine, strictement positif sinon.
titreidsThemeParRevue	array<integer>	Liste d'identifiants de titres. Ce champ n'est présent que s'il est significatif (par exemple, grappe de titres).
themesThemeParRevue	array<object>	—
bouquetpartenaireTitre	string	Ce champ est présent et non-null si le titre a été produit par une recherche sur les possessions, par exemple dans la requête /mes/titres. Il contient le bouquet déclaré par le partenaire pour ce titre dans ses possessions.
editeursTitre	array<string>	Liste des noms d'éditeurs actuels. Voir `relations_editeurs` pour une liste plus détaillée.
identifiantpartenaireurlTitre	string	L'URL complète pour accéder à ce titre dans la bibliothèque du partenaire. Ce champ est null si le partenaire n'est pas identifié, ou que ce titre n'est pas dans ses possessions, ou qu'il n'a pas de lien associé à cette possession.
issnsTitre	array<object>	Liste des identifiants, notamment ISSN, attachés au titre.
labellisationTitre	array<string>	Ne peut actuellement contenir que des valeurs parmi "DDH diamond journal" et "Catálogo 2.0 Latindex".
languesTitre	array<string>	Liste des langues de ce titre, par leurs codes ISO-639-2-B à 3 lettres (exemple "fre"). Dans une prochaine version, l'API diffusera ces langues en ISO-639-2-T (exemple "fra"), donc il est recommandé de savoir interpréter l'ensemble de ISO-639 (variantes B et T).
liensextTitre	array<array<string>>	Liste de liens, sous la forme de couples [URL, nom (DOAJ, etc)] pour ce titre.
obsoleteparTitre	integer	Éventuel identifiant numérique du titre qui a remplacé celui-ci dans la revue.
periodiciteTitre	string	Périodicité.
relations_editeursTitre	array<object>	Ce champ n'est présent que dans les requêtes cherchant un titre unique, autrement dit /titres/{id}.
sigleTitre	string	Nom bref (sigle ou acronyme).
url_revue_mirabelTitre	string	Page web de la revue sur le site de Mir@bel.
codeErreur	integer (int32)	Code HTTP de l'erreur
messageErreur	string	Description détaillée du problème
fieldsErreur	string	Éventuels champs créant un trouble dans la requête
detailsErreur	object	Éventuels détails sur l'erreur.
nouvelidRedirection	integer (int32)	identifiant de l'objet après redirection

Schema captured from openapi 1 day ago.

Verification Status

Using the API

Configuration

Base URL: https://reseau-mirabel.info/api
Format: openapi

Query examples

curl -s 'https://reseau-mirabel.info/api' -H 'Accept: application/json'

Base API endpoint — see the documentation for available routes.

Full API documentation ↗

Machine-readable & source

OpenAPI spec JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.