What is OpenSearch?

With the new JAIRO, it is possible to interact with JAIRO using OpenSearch*. Here, we will explain the basics of searching with OpenSearch

※For more information about OpenSearch, please refer to the following website.
http://www.opensearch.org/Specifications/OpenSearch/1.1


▲Top of page


Search JAIRO with your browser’s search bar.

Search CiNii with the search bar on Firefox.


1. Click on the Firefox search bar and select "JAIRO"



2. Enter keyword(s) in the search bar and the browser will take you to the article search results page.



Search JAIRO with the search bar on Internet Explorer.


1. Click on the Internet Explorer(more than 7) search bar and select "JAIRO"



2. Enter keyword(s) in the search bar and the browser will take you to the article search results page.



▲Top of page


Search JAIRO using an OpenSearch query.

It is possible to search JAIRO using an OpenSearch query in the same manner as using the search feature of the JAIRO website.


Base URL of Opensearch
http://jairo.nii.ac.jp/opensearch/search

Request parameter
Add requests following the base URL.
http://jairo.nii.ac.jp/opensearch/search?(parameter=value)&(parameter=value)&…&(parameter=value)
ex.) http://jairo.nii.ac.jp/opensearch/search?q=abc&count=10&lang=en


Each parameter that comprises the query is as follows.


Use UTF-8 for character encoding.

Parameter name Content
q A free word is specified.
count The result of the retrieval per page number is specified.
lang The language of the retrieval result is specified.
start The beginning number of the acquired search result list is specified.
format The format of the return result is specified.
title It retrieves it by the title.
author It retrieves it by the name of the author.
keyword It retrieves it by the key word.
journal It retrieves it by the magazine name.
issn It retrieves it with ISSN.
sortorder The sorting condition is specified.

  RSS Response Format Specification

Hierarchy1 Hierarchy2 Hierarchy3 Hierarchy4 Description Content of description
rss         「2.0」
        string  
  channel        
    title   string Has connected the query to "JAIRO OpenSearch|"
    link   anyURI URI of query
    description   string When language is ja
「JAIRO(ジャイロ)は国立情報学研究所が提供する日本の学術機関リポジトリポータルです。日本の学術機関リポジトリに蓄積された学術雑誌論文,学位論文,紀要論文,研究報告書等を検索することができます。」
When language is en
「JAIRO is a service that provides a cross-search of Institutional Repositories making it possible to discover the educational and research outcomes (Journal Article, Thesis or Dissertation, Departmental Bulletin Paper, Research Paper, etc.) disseminated from universities and academic institutions in Japan.」
    language   language 「ja」 or 「en」
    copyright   string 「Copyright(C) National Institute of Informatics」
    pubDate   dateTime Date when search was executed
    opensearch:totalResults   string Total search results
    opensearch:startIndex   string Start number
    opensearch:itemsPerPage   string Results per page
    image      
      url anyURI 「http://jairo.nii.ac.jp/
images/jairo_logo.jpg」
※URL of logo image
      link anyURI URI of query
      title string Has connected the query to "JAIRO OpenSearch|"
    item      
      title string Title
      link anyURI The permalink is displayed.
      description string Content description
      author string Author
      category string NIIType
      pubDate dateTime Date of publication

  atom Response Format Specification

Hierarchy1 Hierarchy2 Hierarchy3 Hierarchy4 Description Content of
description
feed         "root" element
xmlns=
"http://www.w3.org/
2005/Atom"
xmlns:prism=
"http://prismstandard.org/
namespaces/basic/2.0/"
xmlns:opensearch=
"http://a9.com/-/
spec/opensearch/1.1/"
  title        
  link     anyURI URI of query
  id     anyURI URI of query
  updated     dateTime Date when retrieval was done
  opensearch:
totalResults
    string Total search results
  opensearch:
startIndex
    language Start number
  opensearch:
itemsPerPage
    dateTime Results per page
  entry        
    title   string Title
    link     The permalink is displayed.
    id   anyURI The permalink is displayed.
    author      
      name stirng Name of author
    prism:publicationName   stirng Magazine name
    prism:issn   stirng ISSN
    prism:volume   stirng Volume
    prism:number   stirng number
    prism:startingPage   stirng Start page
    prism:endingPage   stirng End page
    prism:publicationDate   dateTime Date of publication
    content   stirng Article abstract
    updated   dateTime Date of publication

▲Top of page


OpenSearch RSS and Atom Feed.

You can check for updates to the results of an OpenSearch keyword search if you bookmark the results page in an RSS or Atom feeder.


Example: bookmark in the Firefox RSS reader.


・ An OpenSearch RSS or Atom feeder search results page is displayed.
・ Push the “subscribe” button.



・ On the “add live bookmark” window, push the “add” button.



・ The search results RSS feed is bookmarked on the bookmarks toolbar.



▲Top of page


Specifications for the OpenURL receiving function

It is possible to search JAIRO using an OpenURL query in the same manner as using the search feature of the JAIRO website.


Base URL of OpenURL
http://jairo.nii.ac.jp/openurl/query


Request parameter Add requests following the base URL.
http://jairo.nii.ac.jp/openurl/query?(parameter=value)&(parameter=value)&…&(parameter=value)
ex.) http://jairo.nii.ac.jp/openurl/query?any=abc&rft.issn=10&rft.pages=5


Each parameter that comprises the query is as follows.
Use UTF-8 for character encoding.

Parameter name Content
rft_id DOI number is retrieved.
ex.) rft_id=info:doi/
rft.issn ISSN is retrieved.
rft.au The name of the author is retrieved.
rft.jtitle The magazine name is retrieved.
rft.atitle The title is retrieved.
rft.volume The volume is retrieved.
rft.issue The title is retrieved.
rft.pages The page is retrieved.
when you enter "rft.pages=x-y", search using "start page=x" OR "end page=y"
rft.spage The beginning page is retrieved.
rft.epage The end page is retrieved.
rft.date The publication year is retrieved.
rfe_dat NCID is retrieves.
any Everything is retrieved.

Retrieval result display
A different page will be displayed depending on the search condition.
・If the search returns only one article, the detailed information screen will be displayed.
・For conditions other than the above, the search result list screen will be displayed.
・When a search yields no results, "0 results" is displayed.


▲Top of page