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 "&", 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 "&", 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 "&" 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 | ||||||