CiNii Books - Metadata and API - CiNii Books OpenSearch for Authors

 

Query Specification

CiNii Books OpenSearch query for Authors is as follows.
http://ci.nii.ac.jp/books/opensearch/author?(parameter=value)& (parameter=value)&…&(parameter=value)

Each parameter that comprises the query is as follows. Parameters other than this table is disregarded.

No. Item Name Parameter Name Availability of Boolean expression Remarks
1 Author Name name Possible(AND) Partial match or exact match of Author Name ID. Required
2 Output format format Impossible atom:ATOM format (default), rss: RSS format, json: JSON-LD format, html:HTML format
3 Sort Order sortorder Impossible 1: Sorts by relevance in descending order(default), 2: Sorts by name in ascending order of character code (A to Z), 3: Sorts by name in descending order of character code (Z to A), 4: Sorts by number of books with the lowest number at the top, 5: Sorts by number of books with the highest number at the top
4 Search Page Number p Impossible The first page is 1.
5 Number of outcome per one page count Impossible Default is 20
6 Application ID appid Impossible Required
  • 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.
 

Response Specification

You can choose the response format with query from RSS, Atom, JSON-LD and HTML.

"Access-Control-Allow-Origin" is required on http header for response, and it is available to use asynchronous communication between cross domains.

 

RSS1.0 Response Format Specification

No. Tag name Required Content Remarks
First level Second level Third level Fourth level Fifth level Attribute
1 xml           Required Declare as XML document <?xml version="1.0" encoding="utf-8" ?>
2 rdf:RDF           Required Document route element Language code of the response will appear at xml:lang attribute. Other attributes are as follows.
  <rdf:RDF
xmlns xmlns="http://purl.org/rss/1.0/"
xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:rdfs xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
xml:lang xml:lang=”ja”>
3   channel       rdf:about Required Requested URI This is a search request URI. URL-encorded query is output with "variable identifier=value" format. Connects with "&amp;" ,and "appid" will be removed from parameter.
4     title       Required Title Concatenation with query to "CiNii Books Author -" .
Example:
<title>CiNii Books Author - 大向</title>
5     description       Required Title Same as the above
6     link       Required Requested URI This is a search request URI. URL-encorded query is output with "variable identifier=value" format. Connects with "&amp;", and "appid" will be removed from parameter.
7     dc:date       Required Date when search was executed W3CDTF format
8     opensearch:totalResults       Required Total search results  
9     opensearch:startIndex       Required Start number Indicates from which record number among the search results the data is being described.
10     opensearch:itemsPerPage       Required Results per page Indicates how many search results are included in the response.
11     items       Required    
12       rdf:Seq     Required    
13         rdf:li rdf:resource Required URI of Bibliography Details Page Indicates how many search results are included in the response. Repeated at most until the number of opensearch:itemsPerPage.
14   item       rdf:about Required Author information Repeated at most until the number of opensearch:itemsPerPage. The permalink is described in rdf:about.
<item rdf:about="http://ci.nii.ac.jp/author/XX12345678">
15     title       Required Author name  
16     link       Required URI of Author Details Page Indicates the permalink in Author details page.
<link>http://ci.nii.ac.jp/author/XX12345678</link>
17     rdfs:seeAlso     rdf:resource Required URI of Author RDF Indicates the URI of Author RDF (except parameter of appid)
<rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/author/XX12345678.rdf" />
18     description         Author name transcription  
19     dc:date       Required Date of update Date when the search was executed.
 

Atom1.0 Response Format Specification

No. Tag name Required Content Remarks
First level Second level Third level Fourth level Attribute
1 xml         Required Declare as XML document <?xml version="1.0"encoding="UTF-8" ?>
2 feed         Required Document route element Language code of the response will appear at xml:lang attribute. Other attributes are as follows.
  <feed
xmlns xmlns="http://www.w3.org/2005/Atom"
xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
xml:lang xml:lang=”ja”>
3   title       Required Feed title Concatenation with query to "CiNii Books Author-".
例:
<title>CiNii Books Author - 大向</title><
4   link     href Required Query URL URL of Equivalent search with HTML. URL-encorded query is output with "variable identifier=value" format. Connects with "&amp;" and "appid" will be removed from parameter.
5   link     rel Required Relation with reference at linked page Fixed: "self"
6         type Required MIME type of reference at linked page Fixed: "application/atom+xml"
7         href Required Requested URI This is a search request URI. URL-encorded query is output with "variable identifier=value" format. Connects with "&amp;" and "appid" will be removed from parameter.
8   id       Required Requested URI Same as the link element.
9   updated       Required Date when search was executed W3CDTF format
10   opensearch:totalResults       Required Total search results  
11   opensearch:startIndex       Required Start number Indicates from which record number among the search results the data is being described.
12   opensearch:itemsPerPage       Required Results per page Indicates how many search results are included in the response.
13   entry         Container that stores information on author search results. Repeated at most until the number of opensearch:itemsPerPage.
14     title     Required Author name  
15     link   href Required URI of Author Details Page Indicates the permalink in Author details page.
<link href="http://ci.nii.ac.jp/author/XX12345678"/>
16     link   rel Required Relation with reference at linked page Fixed: "alternate"
17         type Required MIME type of reference at linked page Fixed: "application/rdf+xml"
18         href Required URI of Author RDF Indicates the URI of Author RDF (except parameter of appid)
href="http://ci.nii.ac.jp/author/XX12345678.rdf"
19     id     Required URI of Author Details Page Indicates the permalink in Author details page.
<id>http://ci.nii.ac.jp/author/XX12345678</id>
20     content       Author name transcription Example:
<content type="text">オオムカイ, イッキ</content>
21         type     Fixed: "text"
22     updated     Required Date of update Date when search performed
 

JSON-LD Response Format Specification

No. Tag Name Type Required Contents Remarks
First level Second level Third level Fourth level Fifth level
1 @context         Object Required Document route element "@context": {
"dc": "http://purl.org/dc/elements/1.1/",
"rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
"opensearch": "http://a9.com/-/spec/opensearch/1.1/",
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"@vocab": "http://purl.org/rss/1.0/"
},
2   @vocab         Required   http://purl.org/rss/1.0/
3   dc         Required   http://purl.org/dc/elements/1.1/
4   rdf         Required   http://www.w3.org/1999/02/22-rdf-syntax-ns#
5   opensearch         Required   http://a9.com/-/spec/opensearch/1.1/
6   rdfs         Required   http://www.w3.org/2000/01/rdf-schema#
7 @id           Required Requested URI This is a search request URI. URL-encorded query is output with "variable identifier=value" format. "appid" will be removed from parameter.
8 @graph         Array Required   Element count of array is 1
9   @id         Required Requested URI This is a search request URI. URL-encorded query is output with "variable identifier=value" format. "appid" will be removed from parameter.
10   @type         Required   Fixed: "channel"
11   title         Required Title Concatenation with query to "CiNii Books Author"
Example:
"title":"CiNii Books Author - 大向",
12   description         Required Title Same as the above
13   link       Object Required    
14     @id       Required Requested URI This is a search request URI. URL-encorded query is output with "variable identifier=value" format. "appid" will be removed from parameter.
15   dc:date         Required Date when search was executed W3CDTF format
16   opensearch:totalResults         Required Total search results  
17   opensearch:startIndex         Required Start number Indicates from which record number among the search results the data is being described.
18   opensearch:itemsPerPage         Required Results per page Indicates how many search results are included in the response.
19   items       Array      
20     @id       Required URI of Author Details Page Indicates the permalink in Author Details Page
21     @type       Required   Fixed: "item"
22     title       Required Author name  
23     link     Object Required    
24       @id     Required URI of Author Details Page Indicates the permalink in Author Details Page.
"link": {"@id":"http://ci.nii.ac.jp/author/XX12345678"},
25     rdfs:seeAlso     Object Required    
26       @id     Required URI of Author JSON-LD Indicate the URI of Author JSON-LD (except parameter of appid)
"rdfs:seeAlso":{"@id":"http://ci.nii.ac.jp/author/XX12345678.json"},
27     description         Author name transcription  
28     dc:date       Required Date of update Date when search performed
 

Revision History

You can check revision history of CiNii Articles JSON-LD API for Articles later April, 2013.

March 13, 2015

JSON-LD response format has been partly changed. The details are as follows;

  • Type of "items" tag has changed from "Object" to "Array".
  • "rdf:Seq" and "rdf:li" tags have not been used.
  • CiNii Web APIs by JSON-LD has become official version.

October 11, 2013

  • JSON-LD Format (json) has added to output format for Query Specification.
  • JSON-LD (Beta version) has added to Response Format Specification.
  • It has been available to use asynchronous communication between cross domains.