Outline of Ichushi-Web-API
Ichushi-Web-API allows you to use the Ichushi-Web data from external services. There are three compatible protocols: OpenURL, OpenSearch, and SRU.
If you have a contract with the Ichushi-Web, you can use all the Ichushi-Web-API for free. In other cases, it may be used for a fee or free of charge, depending on the purpose of use.
OpenURL
It is useful as a resolver target for registration, search, etc. When accessed, it interfaces the Ichushi-Web.
Access
Base URL:
https://search.jamas.or.jp/api/openurl?
Parameters:
| url_ver (mandatory) | Fixed value "Z39.88-2004" |
| rfr_dat | Ichushi Document Number |
| rft.atitle | Article title |
| rft.jtitle | Periodical title |
| rft.issn | ISSN print |
| rft.eissn | ISSN online |
| rft.aulast | Last name of principal author |
| rft.aufirst | First name of principal author |
| rft.aucorp | Corporate author |
| rft.date | Publication year |
| rft.volume | Volume |
| rft.issue | Issue |
| rft.spage | First page |
| rft.pages | First and last pages |
Access example
Access to the following article on the Ichushi-Web
Document ID：2024069945
Title：臨床的な脳卒中はアルツハイマー病およびレビー小体病変の発症を抑制する(Clinical stroke is associated with fewer Alzheimer's and Lewy body pathologies)
Author：Shinohara Mitsuru(National Center for Geriatrics and Gerontology), Gheni Ghupurjan, Bu Guojun, Sato Naoyuki
Source：Dementia Japan(1342-646X) Vol.37(4) Page705 (2023.10)
Article type：Conference proceeding
Description of OpenURL
https://search.jamas.or.jp/api/openurl?url_ver=Z39.88-2004&url_ctx_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Actx&rfr_id=info%3Asid%2Fjamas.or.jp%3Aichuweb&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Ajournal&rft.genre=article&rfr_dat=2024069945&rft.issn=1342-646X&rft.atitle=%E8%87%A8%E5%BA%8A%E7%9A%84%E3%81%AA%E8%84%B3%E5%8D%92%E4%B8%AD%E3%81%AF%E3%82%A2%E3%83%AB%E3%83%84%E3%83%8F%E3%82%A4%E3%83%9E%E3%83%BC%E7%97%85%E3%81%8A%E3%82%88%E3%81%B3%E3%83%AC%E3%83%93%E3%83%BC%E5%B0%8F%E4%BD%93%E7%97%85%E5%A4%89%E3%81%AE%E7%99%BA%E7%97%87%E3%82%92%E6%8A%91%E5%88%B6%E3%81%99%E3%82%8B%28Clinical+stroke+is+associated+with+fewer+Alzheimer%27s+and+Lewy+body+pathologies%29&rft.jtitle=Dementia+Japan&rft.aulast=Shinohara&rft.aufirst=Mitsuru&rft.date=2023-10&rft.volume=37&rft.issue=4&rft.spage=705&rft.pages=705
OpenSearch
It searches for article information on the Ichushi-Web from an external system. It links websites, blogs, etc. to search results of the Ichushi-Web. When accessed, it shows the search results in the article search display on the Ichushi-Web.
Access
BaseURL
https://search.jamas.or.jp/api/opensearch?
Parameters
| q (mandatory) | Search keywords |
| count | Number of search outputs per page |
| startindex | Start position of record to be obtained |
| format | Parameter that specifies a response format |
Link form examples
<a href="https://search.jamas.or.jp/api/opensearch?q=山中伸弥/FAU or YamanakaShinya/FAU"target="_blank">山中伸弥/FAU or YamanakaShinya/FAU</a>
SRU
SRU is a protocol for searching online and retrieving results from external services. Search is executed using the COL notation.
ICHUSHI-SRU has the Ichushiweb Context Set, or PRISM with additional original search tags, to specify all fields of the Ichushi-Web data. The search results are provided in XML format (PRISM2.1).
It is also possible to retrieve Ichushi-Web data from an external system using keywords or to search for data of an article written by a university faculty member based on the faculty member's name.