OpenSearch for Querying the Database

We provide OpenSearch API for machine friendly search. OpenSearch API is compatible to OpenSearch API 1.1．As you can search researchers in the html page, you can also search researchers with a combination of some field parameters. Please read the following description of the query and response format.
Before use OpenSearch, please resist AIP Key on this page.
Currently, you can make free use of OpenSearch without API Key, but in the future, when the additional features like of access control for API Key and so on, contact you by registered mail address.

Here is the template.

http://rns.nii.ac.jp/opensearch?q{field}={searchTerms}&start={startIndex?}&count={count?}&sort={sortOrder?}

*searchTerms must be URL-encoded in UTF-8.

Field parameters. You have to set the field number to specicty search field.

q0	Search by all fields
q1	Search by researcher name
q2	Search by institution
q3	Search by department
q4	Search by job title
q5	Search by KAKENHI Researcher Number
q6	Search by Researcher Name Resolver ID
q7	Search by research keywords of KAKENHI research projects
q8	Search by research fields KAKENHI research projects

The search method of fields parameters

Common to all fields	You can use logic operations, such as【AND】,【OR】,【NOT】(These letters are upper-cased) and parenthesis【()】. Space between keywords means the same as 【OR】opereter. kanji variants are the same search results.(e.g.【渡辺】and【渡邊】and【渡邉】are the same results) Prefix match or Suffix match by using wildcard【*】. If searching by wildcard only, all resrchers appear in results. Phrase search by putting double quotes【"】around a set of words.
q0	The search method of each field is the same as that of single field.
q1	Searching exact eatch for first-name only or family-name only or fullname without space(family-name+first-name) by default
q5,6	Searching Three or more digit number by default Exact Match by putting slash【/】around a set of numbers.
etc.	Searching a letter(in Japanese) or a word(in English) by default Exact Match by putting double quotes【"】around a set of words.(without space)

Abont sort order

parameter(sortOrder)	sort order
0	Kana order asc of Researcher Name
1	Kana order desc of Researcher Name
2	Alphabetic order asc of Researcher Name
3	Alphabetic order desc of Researcher Name
4	Kanji code order asc of Researcher Name
5	Kanji code order desc of Researcher Name
6	Score order
Unspecified	If using field is "q7" or "q8", then sort order is "score order", otherwise it is "kana order asc"

Examples

Example 1)

If you want to search a researcher name "Takeda" and get a result set from the 1st item by 20 items, the url is;

http://rns.nii.ac.jp/opensearch?q1=Takeda&start=1&count=20

Example 2)

If you want to search a researcher name "武田" and get a result set from the 1st item by 20 items, the url is;

http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&start=1&count=20

Example 3)

If you want to search a researcher name "Takeda" and sort order is "Alphabetic order asc" and get a result set from the 1st item by 20 items, the url is;

http://rns.nii.ac.jp/opensearch?q1=Takeda&start=1&count=20

When you send a query in the OpenSearch format, for instance,

http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&start=1&count=3

you can get response in XML format which is RSS1.0 as follows:

<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
    xmlns:dc="http://purl.org/dc/elements/1.1/"
    xmlns:content="http://purl.org/rss/1.0/modules/content/"
    xmlns:atom="http://www.w3.org/2005/Atom"
    xmlns:owl="http://www.w3.org/2002/07/owl#"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    xmlns:rns="http://rns.nii.ac.jp/ns#"
    xmlns:kaken="http://kaken.nii.ac.jp/ns#"
    xmlns="http://purl.org/rss/1.0/"
    xmlns:rnsos="http://rns.nii.ac.jp/opensearchextentions#"
  >
  	<channel rdf:about="http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&start=1&count=3">
		<title>Researcher Name Resolver OpenSearch</title>
		<link>http://rns.nii.ac.jp</link>
        <description>Researcher Name Resolver OpenSearch provides search resuts of researchers in Japan.</description>
        <image rdf:resource="http://rns.nii.ac.jp/images/icon/favicon.ico"/>
		<items>
			<rdf:Seq>
				<rdf:li rdf:resource="http://rns.nii.ac.jp/nr/1000060256782" />
				<rdf:li rdf:resource="http://rns.nii.ac.jp/nr/1000020020589" />
				<rdf:li rdf:resource="http://rns.nii.ac.jp/nr/1000080186189" />
			</rdf:Seq>
		</items>
        <atom:link atom:type="application/opensearchdescription+xml" atom:href="http://rns.nii.ac.jp/description.xml" atom:rel="search"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&start=1&count=3" atom:rel="self"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?start=1&count=3&q0=%E6%AD%A6%E7%94%B0" atom:rel="first"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?start=4&count=3&q0=%E6%AD%A6%E7%94%B0" atom:rel="next"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?start=355&count=3&q0=%E6%AD%A6%E7%94%B0" atom:rel="last"/>
        <dc:publisher>National Institute of Informatics</dc:publisher>
		<dc:date>2011-10-13T19:39:16+09:00</dc:date>
		<opensearch:totalResults>357</opensearch:totalResults>
		<opensearch:startIndex>1</opensearch:startIndex>
		<opensearch:itemsPerPage>3</opensearch:itemsPerPage>
        <opensearch:Query opensearch:searchTerms="武田" rnsos:format="rss1.0" rnsos:sortType="0" opensearch:startIndex="1" opensearch:role="request"/>
	</channel>
    <image rdf:about="http://rns.nii.ac.jp/images/icon/favicon.ico">
        <title>Researcher Name Resolver</title>
        <url>http://rns.nii.ac.jp/images/icon/favicon.ico</url>
        <link>http://rns.nii.ac.jp/</link>
    </image>

<item rdf:about="http://rns.nii.ac.jp/nr/1000060256782">
    <title>Researcher Name Resolver - 長田 真紀(1000060256782)</title>
    <link>http://rns.nii.ac.jp/nr/1000060256782</link>
    <content:encoded><![CDATA[
        <dt><a href="http://rns.nii.ac.jp/nr/1000060256782">長田 真紀</a> オサダ マキ - ID:1000060256782</dt>
        <dd>
            <dl>
            	<dt>KAKENHI Researcher Number</dt><dd>60256782</dt>
                <dt>Latest Affiliation(From KAKEN)</dt><dd>上田女子短期大学/講師</dd>
                <dt>Research Field (From KAKEN)</dt><dd>国文学</dd>
                <dt>Keywords (From KAKEN)</dt><dd>山下現有/渡邊海旭/僧侶の妻帯/浄土宗/武田泰淳/仏教/武田芳淳</dd>
                <dt>URI</dt><dd>http://rns.nii.ac.jp/nr/1000060256782</dd>
            </dl>
        </dd>
    ]]></content:encoded>
</item>
<item rdf:about="http://rns.nii.ac.jp/nr/1000020020589">
    <title>Researcher Name Resolver - Takeuchi, Makoto | 竹内 誠(1000020020589)</title>

    <link>http://rns.nii.ac.jp/nr/1000020020589</link>
    <content:encoded><![CDATA[
        <dt><a href="http://rns.nii.ac.jp/nr/1000020020589">竹内 誠</a> タケウチ マコト Takeuchi, Makoto - ID:1000020020589</dt>
        <dd>
            <dl>
            	<dt>KAKENHI Researcher Number</dt><dd>20020589</dt>
                <dt>Latest Affiliation(From KAKEN)</dt><dd>東京学芸大学/教育学部/教授</dd>
                <dt>Research Field (From KAKEN)</dt><dd>日本史</dd>
                <dt>Keywords (From KAKEN)</dt><dd>江戸城/浅草/甲府/町場/後北条氏/戦国大名/品川/城下町/東国/八王子/商業/港湾/流通/江戸/考古学発掘/武田氏/小田原/関東/都市/川越/市/東国都市/商品作物</dd>
                <dt>URI</dt><dd>http://rns.nii.ac.jp/nr/1000020020589</dd>
            </dl>
        </dd>
    ]]></content:encoded>
</item>
<item rdf:about="http://rns.nii.ac.jp/nr/1000080186189">
    <title>Researcher Name Resolver - Kikuta, Toshiro | 菊田 紀郎(1000080186189)</title>
    <link>http://rns.nii.ac.jp/nr/1000080186189</link>
    <content:encoded><![CDATA[
        <dt><a href="http://rns.nii.ac.jp/nr/1000080186189">菊田 紀郎</a> キクタ トシロウ Kikuta, Toshiro - ID:1000080186189</dt>
        <dd>
            <dl>
            	<dt>KAKENHI Researcher Number</dt><dd>80186189</dt>
                <dt>Latest Affiliation(From KAKEN)</dt><dd>山形県立米沢女子短期大学/助教授</dd>
                <dt>Research Field (From KAKEN)</dt><dd>国語学</dd>
                <dt>Keywords (From KAKEN)</dt><dd>御軍列配置とメルクマ-ル/武士ことば/索引化/表音式と表意式の混合/書誌的研究/武士階級の日常語/漢語の転義/身体語彙の表記と配属部首/「武田晴信悪行之事」願文考証/宗教色のこい用語/「茶入」の命名法/位相語/字体類似による誤字の例/識字史/森平右衛門</dd>
                <dt>URI</dt><dd>http://rns.nii.ac.jp/nr/1000080186189</dd>
            </dl>
        </dd>
    ]]></content:encoded>
</item>
</rdf:RDF>

The tags used in the XML response format is as follows.

channel	Channel description in RSS1.0.
rdf:about	URI of this channel type resource
title	A descriptive title for the channel. "Researcher Name Resolver OpenSearch"
link	URL of this service
items	Search result list of items
rdf:seq	List in sequence
rdf:li	Items in list
atom:link atom:rel="self"	The current page URL of result set
atom:link atom:rel="first"	The first page URL of result set
atom:link atom:rel="next"	The next page URL of result set
atom:link atom:rel="last"	The last page URL of result set
item	Item description
rdf:about	URI of this item type resource
title	Descriptive tilte of this item. "Researcher Name Resolver - $researcherName (Researcher Name Resolver ID)"
link	Link to Researcher URI. This is the same as URI of this resource.
content:encoded	HTML encoded description of this item. This may be shown in RSS reader.

You should see the next help document to access the researcher URIs.

OpenSearch for Querying the Database

Overview

Query format in OpenSearch

Field parameters. You have to set the field number to specicty search field.

The search method of fields parameters

Abont sort order

Examples

Example 1)

Example 2)

Example 3)

Response format of result set

About Researcher Name Resolver

Web services

Contact