About the OpenURL Receiving Function for CiNii Research

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. Parameter Name Mandatory Articles Journals Books Dissertations Availability of Boolean expression Remarks
1 url_ver Mandatory Z39.88-2004(fixed) Z39.88-2004(fixed) Z39.88-2004(fixed) Z39.88-2004(fixed) impossible
2 ctx_ver Mandatory Z39.88-2004(fixed) Z39.88-2004(fixed) Z39.88-2004(fixed) Z39.88-2004(fixed) impossible
3 rft_val_fmt Conditionally
mandatory
info:ofi/fmt:kev:mtx:journal(fixed) info:ofi/fmt:kev:mtx:journal(fixed) info:ofi/fmt:kev:mtx:book(fixed) info:ofi/fmt:kev:mtx:dissertation(fixed) impossible If unique data are not specified, the parameter is mandatory.
4 rft.genre Conditionally
mandatory
article(fixed) journal(fixed) book(fixed) (invalid) impossible If unique data are not specified, the parameter is mandatory.
5 ctx_enc
6 rfr_id
7 rft_dat Optional crid/<CRID>、naid/<NAID> crid/<CRID>、ncid/<NCID> crid/<CRID>、ncid/<NCID> crid/<CRID>、naid/<NAID> possible(OR) If there is unique data, prioritize it and exclude other conditions.
8 rft_id Optional info:doi/<doi Number>、info:pmid/<PubMed>、info:hdl/<Handle> info:doi/<doi Number>、info:lccn/<LCCN>、info:ncid/<NCID>、info:hdl/<Handle> info:doi/<doi Number>、info:lccn/<LCCN>、info:ncid/<NCID>、info:hdl/<Handle> info:doi/<doi Number>、info:hdl/<Handle> possible(OR) If there is unique data, prioritize it and exclude other conditions.
9 rft.aulast Optional Author name Author name Author name Author name possible(AND) There is no difference in operation by the difference in parameter values.
If there is an input in both, they will be combined by the AND condition.
10 rft.aufirst Optional Author name Author name Author name Author name possible(AND) There is no difference in operation by the difference in parameter values.
If there is an input in both, they will be combined by the AND condition.
11 rft.auinit
12 rft.auinit1
13 rft.auinitm
14 rft.au Optional Author name Author name Author name Author name possible(AND) There is no difference in operation by the difference in parameter values.
If there is an input in both, they will be combined by the AND condition.
15 rft.aucorp Optional Author affiliation Author affiliation Author affiliation (invalid) possible(AND)
16 rft.btitle Optional Title possible(AND) There is no difference in operation by the difference in parameter values.
If there is an input in both, they will be combined by the AND condition.
17 rft.atitle Optional Article title possible(AND)
18 rft.title Optional Name of journal Title Title Title possible(AND) There is no difference in operation by the difference in parameter values.
If there is an input in both, they will be combined by the AND condition.
19 rft.jtitle Optional Name of journal Title possible(AND) There is no difference in operation by the difference in parameter values.
If there is an input in both, they will be combined by the AND condition.
20 rft.publisher
21 rft.pub Optional Publisher possible(AND)
22 rft.inst Optional Degree-granting university possible(AND)
23 rft.date Optional Publication date Publication date Publication date Degree conferral date impossible W3CDTF Format(YYYY-MM-DD Format)
24 rft.volume Optional Volume impossible
25 rft.issue Optional Number impossible
26 rft.spage Optional Start page impossible
27 rft.epage Optional End page impossible
28 rft.pages Optional Page impossible When you enter rft.pages=x-y, search as "start page=x" OR "end page=y".
In case of rft.pages=ZZZ, search as either start page or end page=ZZZ.
29 rft.issn Optional ISSN ISSN ISSN possible(OR) If there is unique data, prioritize it and exclude other conditions.
30 rft.eissn Optional e-ISSN possible(OR) If there is unique data, prioritize it and exclude other conditions.
31 rft.isbn Optional ISBN ISBN possible(OR) If there is unique data, prioritize it and exclude other conditions.
32 rft.degree Optional Degree title possible(AND)
  • When the search returns only one bibliographic, it redirects to the Details page.
  • If other than above, it clears search criteria and redirects to the Search Results page.
  • If there is no mandatory parameter or there is an error in fixed value, it will return 400Error.