Metadata and API

Metadata and API

CiNii provides Web API (Application Program Interface) for system linkage.
The following three type forms are being provided.

 

OpenURL

OpenURL is a standard of URL for transferring bibliographic information of articles, books and journals, etc. between systems . It is used for linking with library OPAC (Online Public Access Catalog) and Link Resolver, etc.
About details of OpenURL, see the following Page.
OpenURL - Wikipedia, the free encyclopedia

CiNii offers the OpenURL(*Note1) receiving function. Describing a link in the OpenURL format enables links to specific articles, journal information, or search results.
Also, CiNii Articles has the OpenURL sending function (function of showing the link to Link Resolver or OPAC). For more details, see " Open URL Sending Function"

【Function Diagram】(*The OpenURL in the diagram has been simplified)

OpenURL受信機能概念図

About details of receivable parameters, etc., see the each API page.

CiNii Article
About the OpenURL Receiving Function for CiNii Articles>>
About the OpenURL Sending Function for CiNii Articles>>

CiNii Books
About the OpenURL Receiving Function for CiNii Books>>


*NOTE1:OpenURL is a standard description format for transmitting data such as article, book and journal information in the URL format between systems.

 

OpenSearch

Standards for using search results of some web services from other web services etc.
For more information about OpenSearch, please refer to the following website.
http://sites.google.com/site/tsukamoto/doc/opensearch/spec-1-1-draft4

Example of use of OpenSearch

 

A. Search for Articles with your browser’s search bar.

Example : Search for Articles with the search bar on Firefox
* Web browsers such as Internet 7 and 8, etc. are possible to perform the equivalent thing.

  1. Display the CiNii page by Firefox. After clicking on the icon "▼" of the left end of search box, select [Add "CiNii"](or [Add "CiNii Author"]) and add it.

  2. Clicking on the icon "▼" of the left end of search bar, select "CiNii OpenSearch"(or "CiNii Author OpenSearch" etc.).

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

 

B. RSS and Atom Feed

Registering the search results of the keyword into "RSS reader" enables you to check the updates of the keyword.

ex) Registers into the RSS reader of Internet Explorer 9.

  1. Display a search-result.

  2. Choose "RSS 1.0" or "Atom 1.0" from "Tool" > "feeding search".

  3. Contents screen of feed of RSS or Atom is displayed. Click on "subscribe this feed".

  4. Select screen of choosing the directory to save the feed is displayed. Please specify the place.

  5. You can check on "feed" tab of "bookmark", and will be notified when there is updating.

 

C. Request query of OpenSearch to CiNii

Making query of OpenSearch and request to CiNii enable you to search equivalent to search on the screen of CiNii. You can use for system linkage, etc.

  1. Example of query (Article Search):
    http://ci.nii.ac.jp/opensearch/search?q=%E5%AE%89%E9%81%94&count=20&start=1&lang=ja&title=library&author=&affiliation=&journal=&issn=&volume=&issue=& page=&publisher=&references=&year_from=&year_to=&range=&sortorder=&format=rss

  2. Example of response (RSS feed):

  3. query specific

    In CiNii, API is prepared for every search type. About the specification of query and response for each search type, see the each API page.

    CiNii Article
    CiNii Articles OpenSearch for Articles>>
    CiNii Articles OpenSearch for Authors>>
    CiNii Articles OpenSearch for Full text>>

    CiNii Books
    CiNii Books OpenSearch for Books & Journals>>
    CiNii Books OpenSearch for Authors>>
    CiNii Books OpenSearch for Libraries>>
    CiNii Books OpenSearch for Holdings>>

 

RDF

RDF is a standard for expression of metadata (data about data). The abbreviation for Resource Description Framework.
With RDF, CiNii’s data can be utilized in various ways since each data item, like article name or author name, is structured in a standardized way using metadata descriptors such as Dublin Core, etc. and is output with XML.
For more information please refer to the following site.
http://www.w3.org/RDF/

The output method of RDF is as follows.

  1. Display the detailed information page. (RDF can be outputted by each of papers, authors, books and journals and libraries.)

  2. Add ".rdf" to the URL in the address bar. Even when the RDF URL is input directly, the same results are displayed because the RDF URL becomes "details page URL" + ".rdf".
    Example:http://ci.nii.ac.jp/naid/110004744915 → http://ci.nii.ac.jp/naid/110004744915.rdf

  3. The content of the details page is output with RDF.


About details of a format, see the each API page.

CiNii Article
CiNii Articles RDF for Articles>>
CiNii Articles RDF for Authors>>


CiNii Books
CiNii Books RDF for Books & Journals>>
CiNii Books RDF for Authors>>
CiNii Books RDF for Libraries>>

API User Registration

API user of OpenSearch and RDF, please register from the following.

API User Registration>>