Help - Metadata and API - OpenSearch - CiNii Articles OpenSearch for Authors

Query Specification

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

Each parameter that comprises the query is as follows.

No.	parameter	content
1	q	Specifies keyword to be searched (required)
		This parameter is necessary to encode the URL.
2	count	Specifies the number of search results per page (optional)
		The default is 20. When a value under 0 or exceeding 200 is specified, or when no value is specified, it will be considered as the default value. (The maximum number of search results that can be displayed on a single page is 200.)
3	lang	Specifies the language the search results are displayed in (optional)
		The default is ja. Specify Japanese (ja) or English (en). When a character string other than ja or en is specified, or when no character string is specified, it will be considered as the default value.
4	start	Start number for the acquired search result list (optional)
		The default is 0. When a value under 0 or exceeding the number of results is specified, it will be considered as the default value.
5	format	Specifies the format of the response (optional)
		The default is xhtml (regular search results page). rss/atom can be specified. The rss/atom format is described later.
6	sortorder	Specifies the sorting condition. The default is 1.
		author name: descending order 1 / ascending order 2
		No. of articles:decending 3

Response Specification

You can specify the format of a response from RSS, Atom and HTML by query.

1. 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#"
   						xxmlns: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		Requested URI	Encoded query as "parameter=value" and connect by "&amp;".
   4			title					Title	Query will come after "CiNii Author OpenSearch-".
   									<title>CiNii Author OpenSearch - Kokujyou+Taro</title>
   5			link					Requested URI
   6			description					Requested URI
   7			dc:date					Date when search was executed	W3CDTF format
   8			opensearch:totalResults					Total search results
   9			opensearch:startIndex					Start number	Indicates from which record number among the search results the data is being described.
   10			opensearch:itemsPerPage					Results per page	Indicates how many search results are included in the response.
   11			items
   12				rdf:Seq
   13					rdf:li	rdf:resource		Permalink	Lists the permalink to the author(s) included in the response.
   14		item				rdf:about		Author information	Describe the permalink with rdf:about.
   									<item rdf:about="http://ci.nii.ac.jp/nrid/1000080143551">
   15			title					Author name
   16			link					Permalink
   17			rdfs:seeAlso			rdf:resource		URL of the RDF	<rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/nrid/1000080143551.rdf" />
   18			description					Affiliated institution
   19			dc:subject					Research fields
   20			dc:date					Publication Date	The same as prism:publicationDate

   
   
2. 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: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		title					Feed title	Query will come after "CiNii Author OpenSearch -"
   								<title>CiNii Author OpenSearch - Kokujyou+Taro</title>
   4		link			href		Query URI	Encoded query as "parameter=value" and connect by "&amp;".
   5		link			rel		Relation to document reference ahead	rel="self"
   6					type		MIME Type
   7					href		Query URI
   8		id					Query URI	Same as the link element.
   9		updated					Date when search was executed	W3CDTF format
   10		opensearch:totalResults					Total search results
   11		opensearch:startIndex					Start number	Indicates from which record number among the search results the data is being described.
   12		opensearch:itemsPerPage					Results per page	Indicates how many search results are included in the response.
   13		entry					Container that stores information on article search results
   14			title				Author name
   15			link		href		Author URI	Permalink of the author.
   16			link		rel		Relation to document reference ahead	rel="alternate"
   17					type		MIME Type
   18					href		URI of document reference ahead
   19			id				Author URI	Permalink of the author.
   20			content				Affiliated institution	The displayed content is assumed to be that which is displayed when the user is not logged in.
   								<content type="text"></content>
   21			dc:subject				Research fields
   22			updated				Date of publication