CiNii Research OpenSearch

 

Query Specification

CiNii Research OpenSearch query is as follows.
https://cir.nii.ac.jp/opensearch/(search type)?(parameter=value)& (parameter=value)&…&(parameter=value)

Query example:https://cir.nii.ac.jp/opensearch/all?q=abc&title=de&count=200&sortorder=0&format=rss

Each parameter and search type that comprises the query is as follows.

item parameter All Data Articles Books Dissertations Projects Availability of Boolean expression Conditions for multiple inputs (space or "," if specified in the remarks) Remarks
Search type - all data articles books dissertations projects
Application ID appid × impossible Mandatory
Response format format × impossible Specifying the output format
Select from the following 4 types of character strings
html(default)
rss
atom
json
Search result language lang × impossible Specify the description language of the output format
ja(default)
en
Sort order at output sortorder × impossible 0:publication year, degree award year, research start year:Newest
1:publication year, degree award year, research start year:Oldest
4:Relevance(default)
10:number of citations:descending order (articles only)
Number of items per page count × impossible default=20, natural numbers from 1 to 200
20 if it is not a natural number or less 0
200 if it is above 201
If format = html, convert the number of items displayed per page,the number of items displayed per page is rounded up to 20, 50, 100,and 200.
201 and above is 200
Search result list start number start × impossible natural number
Other than that,
default=1
If format = html, convert to the number of screen pages
start / (number of items per page)
if there is too much, + 1
Free word q AND
Person name creator AND
Start year from - × impossible YYYY
YYYYMM
End year until × impossible YYYY
YYYYMM
Provision of actual data Format datasetFormat OR
With text hasLinkToFullText × impossible Search by specifying true or false. Specify true if you want to perform a title exact match search.
title
project title
title AND
Title Exact match isFullTitle - - - - - × impossible Search by specifying true or false. Specify true if you want to perform a title exact match search.
Author ID researcherId - - - × OR
Affiliation affiliation - - AND
Publication title publicationTitle - - - - AND
ISSN issn - - × OR
Volume volume - - - - × impossible
No. number - - - - × impossible
Pages pages - - - - × impossible If pages = x-y is entered, the search will be performed as "start page = x" OR "end page = y".
If pages = ZZZ, the start page or end page is ZZZ
ISBN isbn - - - - - OR
NCID ncid - - - - - OR
Classification category - - - - - OR
Note / Abstract description - - - - AND
degree-granting university awardInstitution - - - - - AND
degree title degree - - - - - AND
degree award year awardYear - - - - - × impossible YYYY
YYYYMM
Publisher publisher - - - AND
project / area number projectId - - - - - × OR
DOI doi - - × OR
Datasource type datasourceType × impossible The following character string
Separate multiple items with ","
KAKEN(KAKEN)
JALC(Japan Link Center)
IRDB
CROSSREF(Crossref)
DATACITE(DataCite)
CID(CiNii Dissertations)
CIB(CiNii Books)
SSJDA(SSJ Data Archive)
NINJAL(National Institute for Japanese Language and Linguistics)
IDR(Informatics Research Data Repository)
DBPEDIA(DBpedia)
RUDA(Rikkyo University Data Archive)
Language type languageType × OR Specify with ISO-639-1
Separate multiple items with ","
Example) When searching in Japanese, English, or Chinese
languageType=ja,en,zh
Resource type resourceType - - - × OR following character string
Separate multiple items with ","
conference pape
data paper
departmental bulletin paper
editorial
journal article
newspaper
periodical
review article
software paper
article
journal_article
book
Audiovisua
Collection
Dataset
Event
Image
InteractiveResource
Model
PhysicalObject
Service
Software
Sound
Text
Workflow
Other
journal
 

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 Contents Remarks
First level Second level Third level Fourth level Fifth level Attribute
1 xml Required Declares that it is a required XML document
2 rdf:RDF Required Document root element xml: lang attribute describes the language to be returned. Describe the following character strings for attributes other than xml: lan
3
4 xmlns xmlns="http://purl.org/rss/1.0/"
5 xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
6 xmlns:rdfs xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
7 xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
8 xmlns:prism xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/"
9 xmlns:ndl xmlns:ndl="http://ndl.go.jp/dcndl/terms"
10 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
11 xmlns:cir xmlns:cir="https://cir.nii.ac.jp/schema/1.0/"
12 xml:lang xml:lang=”ja”>
13 channel rdf:about Required Requested URI The URI of this search request. URL-encode the query and output it in the "variable name = value" format. Connect with "& amp;". Appid is removed from the parameter.
14 title Required title "CiNii Research" and search type concatenated with query and "200 0 rss".
Example: <title>CiNii Research all - Taro Kokujo 200 0 rss</title>
15 description Required title Same content as title
16 link Required Required URI The URI of this search request. URL-encode the query and output it in the "variable name = value" format. Connect with "& amp;". Appid is removed from the parameter.
17 dc:date Required Date and time when the search was performed W3CDTF notation
18 opensearch:totalResults Required Total search results
19 opensearch:startIndex Required start number Displays the number of data in the search results to be described.
20 opensearch:itemsPerPage Required Count Show how many search results are included in the response.
21 items Required
22 rdf:Seq Required
23 rdf:li rdf:resource Required Detail page URI Repeat up to the number of opensearch:itemsPerPage. Describe the permalink in rdf:about.
24 item rdf:about Required detailed information (detail page URI) Repeat up to the number of opensearch:itemsPerPage. Describe the permalink in rdf:about.
<item rdf:about="https://cir.nii.ac.jp/crid/1234567890123">
25 title Required author name
title
26 link Required Detail page URI Display the detail page permalink
<link>https://cir.nii.ac.jp/crid/1234567890123</link>
27 rdfs:seeAlso rdf:resource Required RDF URI Show RDF URI (except appid parameter)
<rdfs:seeAlso rdf:resource="https://cir.nii.ac.jp/crid/1234567890123.rdf" />
28 dc:creator Required author name
29 dc:publisher publisher
For dissertations, the name of the degree-granting university.
dc:type Required data type
31 prism:publicationName Publication name
32 prism:issn ISSN
33 prism:volume volume
34 prism:number number
35 prism:startingPage Start page
36 prism:endingPage End page
37 prism:pageRange Page
38 prism:publicationDate Publication date
39 description Abstract The abstract is the content that you have not logged in to.
40 dc:identifier Identifier
41 rdf:datatype identifier type
42 (value) Code value of the identifier
43 dc:subject keyword
44 ndl:degreeName Required if any degree title
45 ndl:dissertationNumber Required if any degree conferral number
46 dc:date Required degree conferral date
47 dc:source Required if any Description related to the text link Example:
<dc:source rdf:resource="https://dl.ndl.go.jp/info:ndljp/pid/3189366" dc:title="NDL Digital Collection"/>
48 rdf:resource Required if any URL of full-text public page
49 dc:title Data source name
 

Atom1.0 Response Format Specification

No. Tag name Required Contents Remarks
First level Second level Third level Fourth level Fifth level Attribute
1 xml Required Declares that it is a required XML document
2 feed Required Document root element xml: lang attribute describes the language to be returned. Describe the following character strings for attributes other than xml: lan.
3
4 xmlns xmlns="http://www.w3.org/2005/Atom"
5 xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
6 xmlns:rdfs xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
7 xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
8 xmlns:prism xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/"
9 xmlns:ndl xmlns:ndl="http://ndl.go.jp/dcndl/terms"
10 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
11 xmlns:cir xmlns:cir="https://cir.nii.ac.jp/schema/1.0/"
12 xml:lang xml:lang=”ja”>
13 title Required Feed title CiNii Research" and search type concatenated with query and "200 0 atom".
Example: <title>CiNii Research all - Taro Kokujo 200 0 atom</title>
14 link href Required URL for searching for equivalent content in HTML
15 link rel Required Relationship with referenced document Fixed value (self)
16 type Required MIME type of referenced document Fixed value (application/atom+xm)
17 href Required Requested URI The URI of this search request. URL-encode the query and output it in the "variable name = value" format. Connect with "& amp;". Appid is removed from the parameter.
18 id Required Requested URI Same as the link element
19 updated Required date and time when the search was performed W3CDTF notation
20 dc:date Required date and time when the search was performed W3CDTF notation
21 opensearch:totalResults Required Total search results
22 opensearch:startIndex Required start number Displays the number of data in the search results to be described.
23 opensearch:itemsPerPage Required Count Shows how many search results are included in the response.
24 entry Required Container to store search results Repeat up to the number of opensearch:itemsPerPage.
25 title Required title
26 link href Required Detail page URI Show URI permalink.
<link href="https://cir.nii.ac.jp/crid/1234567890123"/>
27 link rel Required Relationship with referenced document Fixed value(alternate)
28 type Required MIME type of referenced document Fixed value (application/rdf+xml)
29 href Required RDF URI Show detailed RDF URI
href="https://cir.nii.ac.jp/crid/1234567890123.rdf"
30 id Required Detail Page URI Show Permalink for Detail Page.
<id>https://cir.nii.ac.jp/crid/1234567890123</id>
31 author Required Description of the authors List if there are multiple.
32 name Required author name
33 dc:publisher Required publisher
34 dc:type Required data type
35 prism:publicationName Publication name
36 prism:volume volume
37 prism:number numbe
38 prism:startingPage Start page
39 prism:endingPage End page
40 prism:pagePange Page
41 prism:publicationDate Publication date W3CDTF notation
42 content Abstract The abstract is the content that has not been logged in.
43 type Fixed value (text)
44 dc:identifier
45 rdf:datatype
46 (value)
47 dc:subject keyword
48 ndl:degreeName degree title
49 ndl:dissertationNumber degree conferral number
50 dc:date degree conferral date
51 dc:source Required if any description related to the text link Example:
<dc:source rdf:resource="https://dl.ndl.go.jp/info:ndljp/pid/3189366" dc:title="NDL Digital Collection"/>
52 rdf:resource Required if any URL of full-text public pageeL
53 dc:title Required if any Data source name
 

JSON-LD Response Format Specification

No. タグ名 多重度 必須 内容 備考
First level Second level Third level Fourth level Fifth level Attribute
1 @context 1 Object Required Document root 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/"
"ndl":"http://ndl.go.jp/dcndl/terms"
"opensearch": "http://a9.com/-/spec/opensearch/1.1/"
"cir":"https://cir.nii.ac.jp/schema/1.0/"
"@language": "ja"
},
2 @vocab 1 Required http://purl.org/rss/1.0/
3 rdf 1 Required http://www.w3.org/1999/02/22-rdf-syntax-ns#
4 rdfs 1 Required http://www.w3.org/2000/01/rdf-schema#
5 dc 1 Required http://purl.org/dc/elements/1.1/
6 prism 1 Required http://prismstandard.org/namespaces/basic/2.0/
7 ndl 1 Required http://ndl.go.jp/dcndl/terms
8 opensearch 1 Required http://a9.com/-/spec/opensearch/1.1/
9 cir 1 Required https://cir.nii.ac.jp/schema/1.0/
10 @language 1
11 @id 1 Required Requested URI The URI of this search request. URL-encode the query and output it in the "variable name = value" format. Appid is removed from the parameter.
12 @type 1 Required Fixed: "channel"
13 title 1 Required title "CiNii Research" and search type concatenated with query and "200 0 json".
Example:<title>CiNii Research all - Taro Kokujo 200 0 json</title>
14 description 1 Required title Same content as title
15 link 1 object Required
16 @id 1 Required Requested URI The URI of this search request. URL-encode the query and output it in the "variable name = value" format. Appid is removed from the parameter.
17 dc:date 1 Required Date and time when the search was performed W3CDTF notation
18 opensearch:totalResults 1 Required total search results
19 opensearch:startIndex 1 Start number Displays the number of data in the search results to be described.
20 opensearch:itemsPerPage 1 Count Show how many search results are included in the response.
21 items 1..n array
22 @id 1 Detail page URI Display the detail page permalink.
23 @type 1
24 title 1 Author name
title
25 link 1 object
26 @id 1 Detail page URI Display the detail page permalink.
"link": {"@id":"https://cir.nii.ac.jp/crid/1234567890123"}
27 rdfs:seeAlso 1 object
28 @id 1 JSON-LD URI Display JSON-LD URI (except appid parameter).
"rdfs:seeAlso":{"@id":"https://cir.nii.ac.jp/crid/1234567890123.json"}
29 dc:creator 0..n array Required author name
30 dc:publisher 1 publisher
For dissertations, the name of the degree-granting university.
31 dc:type 1 Required data type
32 prism:publicationName 1 Publication name
33 prism:volume 1 Volume
34 prism:number 1 number
35 prism:startingPage 1 Start page
36 prism:endingPage 1 End page
37 prism:pageRange 1 page
38 prism:publicationDate 1 Publication date W3CDTF notation
39 description 1 abstract
40 dc:identifier 0..n identifier
41 @type 1 Identifier type
42 @value 1 Identifier code value
43 dc:subject 0..n keyword
44 ndl:degreeName 1 Required if any degree title
45 ndl:dissertationNumber 1 Required if any degree conferral number
46 dc:date 1 degree conferral date
47 dc:source 0..n array
48 @id 1 Required URL of full-text public page
49 dc:title 1 Required Data source name
 

Revision History

You can check revision history of CiNii Research OpenSearch

Created on October 4, 2021