CiNii Articles - Metadata and API - About the OpenURL Receiving Function for CiNii Articles

Specifications for the OpenURL receiving function

  • The base URL is: https://ci.nii.ac.jp/openurl/query
  • Bibliographical information described in OpenURL 1.0 can be received.（*Please note that OpenURL 0.1 is not supported.）
  • Use UTF-8 for character encoding.
  • CiNii only accepts the following parameters. Other parameters are invalid and will be ignored.

    • No. Item Name Parameter Name Remarks
    1 DOI Number rft_id ex. rft_id=info:doi/<doi number>
    2 ISSN rft.issn ISSN containing alphabetic characterｓ cannot be searched.
    3 e-ISSN rft.eissn
    4 Author last name rft.aulast
    5 Author first name rft.aufirst
    6 Author initial rft.auinit
    7 Author middle initial rft.auinitm Both parameters are used for author last name and author first name. It would be not counted which field is filled.
    8 Author first name initial rft.auinit1
    9 Author name rft.au
    10 Author affiliation rft.aucorp
    11 Article title rft.atitle
    12 Journal title rft.jtitle
    13 Volume rft.volume
    14 Issue rft.issue
    15 Page rft.pages when you enter "rft.pages=x-y", search as "start page=x" OR "end page=y"
    16 Start page rft.spage
    17 End page rft.epage
    18 Date of publication rft.date
    19 NCID or NAID(NII article ID) rfe_dat Example)
    NCID:rfe_dat=ncid/<NCID>
    NAID:rfe_dat=naid/<NAID>
  • A different page will be displayed depending on the search condition.
    • If the search returns only one article (including when NAID is specified) ・・・ Article Details Page
    • If the search parameters are set for journals only (ISSN, eISSN, NCID, Journal Name)・・・ the journal's page in "CiNii Journal with full text Directory"
    • For conditions other than the above ・・・ Article Search Results
    * For 1 and 3, when a search yields no results, "0 results" is displayed; for 2, the top page of CiNii Journal with full text Directory is displayed.
  • Description example)
    https://ci.nii.ac.jp/openurl/query?ctx_ver=Z39.88-2004&url_ver=Z39.88-2004&ctx_enc=info%3aofi%2fenc%3a
    UTF-8&rft_val_fmt=info%3aofi%2ffmt%3akev%3amtx%3ajournal&rfr_id=info%3asid%2fci.nii.ac.jp%3aCiNii&
    rfe_dat=naid%2f110002763494&rft.issn=04478053&rft.eissn=04478053&
    rft.atitle=3.%e5%ad%a6%e8%a1%93%e6%83%85%e5%a0%b1%e3%82%bb%e3%83%b3%e3%82%bf%e3%83%bc%e3%81%ae%e3%83%87
    %e3%82%a3%e3%82%b8%e3%82%bf%e3%83%ab%e5%9b%b3%e6%9b%b8%e9%a4%a8%e3%83%97%e3%83%ad%e3%82%b8%e3%82%a7
    %e3%82%af%e3%83%88+%28%3c%e7%89%b9%e9%9b%86%3e%e3%83%87%e3%82%a3%e3%82%b8%e3%82%bf%e3%83%ab%e5%9b%b3
    %e6%9b%b8%e9%a4%a8%29&
    rft.jtitle=%e6%83%85%e5%a0%b1%e5%87%a6%e7%90%86&rft.aulast=%e5%ae%89%e9%81%94&rft.aufirst=%e6%b7%b3&
    rft.aucorp=%e5%ad%a6%e8%a1%93%e6%83%85%e5%a0%b1%e3%82%bb%e3%83%b3%e3%82%bf%e3%83%bc%e7%a0%94%e7%a9%b6
    %e9%96%8b%e7%99%ba%e9%83%a8&
    rft.date=1996&rft.volume=37&rft.issue=9&rft.spage=826&rft.epage=830