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

Specifications for the OpenURL receiving function of CiNii Books

  • The base URL is: https://ci.nii.ac.jp/books/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 Availability of Boolean expression Remarks
    OpenURL 1.0 OpenURL 0.1
    1 OpenURL1.0 url_ver (not available) impossible z39.88-2004 (fixed)
    2 ctx_ver (not available) impossible z39.88-2004 (fixed)
    3 NCID rft_id (not available) possible (OR) info:ncid/<NCID> There is no difference in operation by the difference in parameter values.
    4 (not available) pid possible (OR) ncid:<NCID>
    5 rfe_dat rfe_dat possible (OR) ncid/<NCID>
    6 ISSN rft.issn issn possible (OR) without hyphen
    7 ISBN rft.isbn isbn possible (OR) without hyphen, Both 10 digits and 13 digits can be searched.
    8 Title rft.title title possible (AND) Search an item included in the title (partial match).
    There is no difference in operation by the difference in parameter values.
    9 rft.btitle (not available) possible (AND)
    10 rft.jtitle (not available) possible (AND)
    11 Author Name rft.au (not available) possible (AND) Search an item included in the Author's name (partial match).
    There is no difference in operation by the difference in parameter values.
    12 rft.aulast aulast possible (AND)
    13 rft.aufirst aufirst possible (AND)
    14 Publisher rft.publisher publisher possible (AND) Search an item included in the Publisher's name (partial match).
    There is no difference in operation by the difference in parameter values.
    15 rft.pub (not available) possible (AND)
    16 Publication year rft.date date impossible integer, maximum 4 digits
    17 Books/Journals rfr.genre genre impossible book, journal (ignores except those two)
  • In the fields which accept a Boolean expression, you can specify relation by AND, OR, NOT, operator (in capital letters) and parenthesis ("(", ")").
    Between AND, OR, NOT and words, blank is required. When you put words without operator, a default relation (operator written with parenthesis in the table) is used.

  • A different page will be displayed depending on the search condition.
    1. If the search returns only one bibliographic ・・・ Book & Journal Details Page
    2. For conditions other than the above(include a search yields no results) ・・・ Book & Journal Search Results
  • Description example)
    https://ci.nii.ac.jp/books/openurl/query?ctx_ver=Z39.88-2004&url_ver=Z39.88-2004&rft_id=info:ncid/BN03417976&rft.isbn=4003101030&rft.title=%E5%9D%8A%E3%81%A3%E3%81%A1%E3%82%83%E3%82%93&rft.au=%E5%A4%8F%E7%9B%AE%20%E6%BC%B1%E7%9F%B3&rft.publisher=%E5%B2%A9%E6%B3%A2%E6%9B%B8%E5%BA%97&rft.date=1989&rft.genre=book