CiNii Dissertations - Metadata and API - CiNii Dissertations OpenSearch for Dissertations

Contents

 

Query Specification

CiNii Dissertations OpenSearch query for Dissertations is as follows.
https://ci.nii.ac.jp/d/search?(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 Free Keyword q Possible(AND) Partial match
2 Title title Possible(AND) Partial match
3 Note and Description description Possible(AND) Partial match
4 Author author Possible(AND) Partial match
5 University grantor Possible(AND) Partial match/Parameter Name：come from junii2
6 Grantor ID grantorid Possible(OR) Exact match search/Parameter Name：come from junii2
7 Grant ID grantid Possible(OR) Exact match search/Parameter Name：come from junii2
8 Types of degree degreename Possible(AND) Partial match/Parameter Name：come from junii2
9 Degree year(from) year_from Impossible Western year.Only either one is also possible. (Even in that case, dissertation whose publication year is unknown can not be searched.)
10 Degree year(to) year_to Impossible Western year.Only either one is also possible. (Even in that case, dissertation whose publication year is unknown can not be searched.)
11 Fulltext fulltext Possible(AND) Partial match
12 Range range Impossible The default is 0. 0:all / 1: full text document on link to partner service
13 Format format Impossible The default is html. html:HTML / rss:RSS1.0 / atom:ATOM / json:JSON-LD
14 Sort Order sortorder Impossible 1: Sorts results with the newest year at the top(default),2: Sorts results with the oldest year at the top,3:Sorts results with the title(A-Z),4:Sorts results with the title(Z-A),5: Sorts by relevance in descending order.
15 Search Page Number p Impossible The first page is 1.
16 Number of outcome per one page count Impossible Default is 20
17 Application ID appid Impossible Exact match
  • 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 Repetition 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
3 xmlns XML namespace xmlns="http://purl.org/rss/1.0/"
4 xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
5 xmlns:rdfs xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
6 xxmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
7 xmlns:ndl xmlns:ndl="http://ndl.go.jp/dcndl/terms"
8 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
9   channel         Required      
10           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.
<channel rdf:about="http://ci.nii.ac.jp/d/search?q=%E5%A4%A7%E5%90%91%E4%B8%80%E8%BC%9D&advanced=false&count=20&format=rss&range=0&sortorder=1">
11     title       Required   Title Concatenation with query to "CiNii Dissertations OpenSearch-" .
12     description       Required   Title Same as the above
13     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.
14     dc:date       Required   Date when search was executed W3CDTF format
15     opensearch:totalResults       Required   Total search results  
16     opensearch:startIndex       Required   Start number Indicates from which record number among the search results the data is being described.
17     opensearch:itemsPerPage       Required   Results per page Indicates how many search results are included in the response.
18     items       Required      
19       rdf:Seq     Required      
20         rdf:li     0..*   Indicates how many search results are included in the response. Repeated at most until the number of opensearch:itemsPerPage.
21           rdf:resource Required   URI of Bibliography Details Page  
22   item           0..* Container of bibliographic information of the search results Repeated at most until the number of opensearch:itemsPerPage.
23           rdf:about Required   URI of Bibliography Details Page Indicates the permalink in Bibliography Details Page.
<item rdf:about="http://ci.nii.ac.jp/d/500000000000"/>
24     title       Required   Title  
25     link       Required   URI of Bibliography Details Page Indicates the permalink in Bibliography Details Page.
<link>http://ci.nii.ac.jp/d/500000000000</link>
26     rdfs:seeAlso       Required   Description of Bibliography RDF Indicates the URI of Bibliography RDF (except parameter of appid)
<rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/d/500000000000.rdf" />
27           rdf:resource Required   URI of Bibliography RDF  
28     dc:creator       Required   Author name  
29     dc:publisher       Required, if any 0..1 University  
30     ndl:degreeName       Required, if any 0..1 Types of degree  
31     ndl:dissertationNumber       Required, if any 0..1 Grant ID  
32     dc:date       Required   Degree year W3CDTF format
33     dc:source       Required, if any 0..* Description of Fulltext link <dc:source rdf:resource="http://dl.ndl.go.jp/info:ndljp/pid/3189366" dc:title="NDL Digital Collections"/>
34           rdf:resource Required, if any 0..1 URL of full text  
35           dc:title Required, if any 0..1 Data source name  
 

Atom1.0 Response Format Specification

No. Tag name Required Repetition 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  
3 xmlns XML namespace xmlns="http://www.w3.org/2005/Atom"
4 xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
5 xmlns:ndl xmlns:ndl="http://ndl.go.jp/dcndl/terms"
6 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
7   title       Required   Feed title Concatenation with query to "CiNii Dissertations OpenSearch-".
8   link     href Required   URL of search page URL of search page with HTML
9   link     rel Required   Relation with reference at linked page Fixed(self)
10         type Required   MIME type of reference at linked page Fixed(application/atom+xml)
11         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.
12   id       Required   Requested URI Same as the link element.
13   updated       Required   Date when search was executed W3CDTF format
14   opensearch:totalResults       Required   Total search results  
15   opensearch:startIndex       Required   Start number Indicates from which record number among the search results the data is being described.
16   opensearch:itemsPerPage       Required   Results per page Indicates how many search results are included in the response.
17   entry         0..* Container that stores information on dissertations search results. Repeated at most until the number of opensearch:itemsPerPage.
18     title     Required   Title  
19     link   href Required   URI of Bibliography Details Page Indicates the permalink in Bibliography Details Page.
<link href="http://ci.nii.ac.jp/d/500000000000"/>
20     link   rel Required   Relation with reference at linked page Fixed(alternate)
21         type Required   MIME type of reference at linked page Fixed(application/rdf+xml)
22         href Required   URI of Bibliography RDF Indicates the URI of Bibliography RDF (except parameter of appid)
href="http://ci.nii.ac.jp/d/500000000000.rdf"
23     link   rel Required   Relation with reference at linked page Fixed(via)
24         href Required   URL of Fulltext link Fulltext link
<link rel="via" href="http://dl.ndl.go.jp/info:ndljp/pid/3189366"/>
25     id     Required   URI of Bibliography Details Page Indicates the permalink in Bibliography Details Page.
<id>http://ci.nii.ac.jp/d/500000000000</id>
26     author     Required   Description of Author  
27       name   Required   Author name  
28     dc:publisher     Required, if any 0..1 University  
29     ndl:degreeName     Required, if any 0..1 Types of degree  
30     ndl:dissertationNumber     Required, if any 0..1 Grant ID  
31     updated     Required   Degree year W3CDTF format
 

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": {
"@vocab": "http://purl.org/rss/1.0/"
"rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"dc": "http://purl.org/dc/elements/1.1/",
"prism": "http://prismstandard.org/namespaces/basic/2.0/",
"opensearch": "http://a9.com/-/spec/opensearch/1.1/"
},
2   @vocab         Required   http://purl.org/rss/1.0/
3   rdf         Required   http://www.w3.org/1999/02/22-rdf-syntax-ns#
4   rdfs         Required   http://www.w3.org/2000/01/rdf-schema#
5   dc         Required   http://purl.org/dc/elements/1.1/
6   prism         Required   http://prismstandard.org/namespaces/basic/2.0/
7   opensearch         Required   http://a9.com/-/spec/opensearch/1.1/
8 @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.
9 @graph         Array Required   Element count of array is 1
10   @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.
11   @type         Required   Fixed:"channel"
12   title         Required Title Concatenation with query to "CiNii Dissertations OpenSearch"
13   description         Required Title Same as the above
14   link       Object Required    
15     @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.
16   dc:date         Required Date when search was executed W3CDTF format
17   opensearch:totalResults         Required Total search results  
18   opensearch:startIndex         Required Start number Indicates from which record number among the search results the data is being described.
19   opensearch:itemsPerPage         Required Results per page Indicates how many search results are included in the response.
20   items       Object      
21     @id       Required URI of the Bibliography Details Page "#article" is added to URI in Article Details Page
22     @type           Fixed:"item"
23     title       Required Title  
24     link     Object Required    
25       @id     Required URI of the Bibliography Details Page Indicates the permalink in Bibliography Details Page.
"link": {@id:"http://ci.nii.ac.jp/d/500000000000"},
26     rdfs:seeAlso     Object Required    
27       @id     Required URI of Bibliography JSON-LD Indicates the URI of Bibliography JSON-LD (except parameter of appid)
"rdfs:seeAlso":{@id:"http://ci.nii.ac.jp/d/500000000000.json"},
28     dc:creator     Array Required    
29       @value     Required Author name  
30     dc:publisher         University  
31     ndl:degreeName         Types of degree  
32     ndl:dissertationNumber         Grant ID  
33     dc:date         Degree year W3CDTF format
34     dc:source     Array      
35       @id     Required URL of full text  
36       dc:title     Required Data source name