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

Query Specification

CiNii Articles OpenSearch for Articles query is as follows.
http://ci.nii.ac.jp/opensearch/search?(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 (necessary when items 6-17 are not specified).
    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 title Searches by article name. It is necessary to encode the URL.
    7 author Searches by author name. It is necessary to encode the URL.
    8 issn Searches by ISSN.
    9 publisher Searches by publisher name. It is necessary to encode the URL.
    10 affiliation Searches by author affiliation. It is necessary to encode the URL.
    11 journal Searches by journal name. It is necessary to encode the URL.
    12 volume Searches by volume.
    13 issue Searches by issue.
    14 page Searches by page.
    15 references Searches by references. It is necessary to encode the URL.
    16 year_from Searches by year of publication (From).
    17 year_to Searches by year of publication (To).
    18 range Specifies the search target option.
    The default is 0. 0:all / 1: full text document on CiNii / 2: full text document on CiNii or link to partner service
    19 sortorder Specifies the sorting condition. The default is 1.
    Year of publication: descending order 1 / ascending order 2
    article name: descending order 3 / ascending order 4
    journal name: descending order 5 / ascending order 6
    no. of cited by: descending order 7


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:prism xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/"
    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 OpenSearch-".
    <title>CiNii OpenSearch - Interaction+大向</title>
    5     link         Requested URI  
    6     dc:date         Date when search was executed W3CDTF format
    7     opensearch:totalResults         Total search results  
    8     opensearch:startIndex         Start number Indicates from which record number among the search results the data is being described.
    9     opensearch:itemsPerPage         Results per page Indicates how many search results are included in the response.
    10     items            
    11       rdf:Seq          
    12         rdf:li rdf:resource   Permalink Lists the permalink to the article(s) included in the response.
    13   item       rdf:about   Article information Describe the permalink with rdf:about.
    <item rdf:about="http://ci.nii.ac.jp/naid/1234567890">
    14     title         Article name  
    15     link         Permalink  
    16     rdfs:seeAlso     rdf:resource   URL of the RDF <rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/naid/1234567890/rdf" />
    17     dc:creator         Author name Repeated if there are multiple items.
    18     dc:publisher         Publisher  
    19     prism:publicationName         Publication name  
    20     prism:issn         ISSN  
    21     prism:volume         Volume  
    22     prism:number         Number  
    23     prism:startingPage         Start page  
    24     prism:endingPage         End page  
    25     prism:pageRange         Pages  
    26     prism:publicationDate         Date of publication W3CDTF format
    27     description         Abstract The displayed content is assumed to be that which is displayed when the user is not logged in.
    28     dc:date         Date of publication 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:prism xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/"
    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 OpenSearch-".
    <title>CiNii OpenSearch - interaction+大向</title>
    4   link     href=   Query URI Encoded query as "parameter=value" and connect by "&amp;".
    5   id         Query URI Same as the link element.
    6   updated         Date when search was executed W3CDTF format
    7   opensearch:totalResults         Total search results  
    8   opensearch:startIndex         Start number Indicates from which record number among the search results the data is being described.
    9   opensearch:itemsPerPage         Results per page Indicates how many search results are included in the response.
    10   entry         Container that stores information on article search results  
    11     title       Article name  
    12     link   href   Bibliography URI Permalink of the bibliography.
    13     link   href   RDF's URI Displays RDF's URI.
    14     id       Bibliography URI Permalink of the bibliography.
    15     author         Repeated if there are multiple items.
    16       name     Author name  
    17     dc:publisher       Publisher  
    18     prism:publicationName       Publication name  
    19     prism:issn       ISSN  
    20     prism:volume       Volume  
    21     prism:number       Number  
    22     prism:startingPage       Start page  
    23     prism:endingPage       End page  
    24     prism:pagePange       Pages  
    25     prism:publicationDate       Date of publication W3CDTF format
    26     content       Article abstract The displayed content is assumed to be that which is displayed when the user is not logged in.
    <content type="text"></content>
    27     updated       Date of publication The same as prism:publicationDate

To top of this page

Next:CiNii Articles OpenSearch for Authors