Help - Metadata and API - OpenSearch - CiNii Books OpenSearch for Libraries

Query Specification

CiNii Books OpenSearch for Libraries query is as follows.
http://ci.nii.ac.jp/books/opensearch/library?(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 Library name name Possible(AND) Partial match or exact match of Library ID. Required
2 Output format format Impossible atom:ATOM format (default), rss: RSS format
3 Sort Order sortorder Impossible 1:Relevance (default), 2: Library ID (ascending order) , 3: Library ID (descending order), 4: Area Code (ascending order) , 5: Area Code (descending order), 6: Library name (A-Z), 7: Library name (Z-A)
4 Page Number p Impossible The first page is 1.
5 Number of outcome per one page count Impossible Default is 20.
6 Application ID appid Impossible Required
  • 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 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 Books Organization -".
      <title>CiNii Books Organization- Osaka Kyoiku University</title>
      5     description           The same as title
      6     link         Requested URI (Appid is removed from a parameter.)
      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 libraries included in the response.
      14   item       rdf:about   Library information Describe the permalink with rdf:about.
      <item rdf:about="http://ci.nii.ac.jp/library/FA123456">
      15     title         Library name  
      16     link         Permalink  
      17     rdfs:seeAlso     rdf:resource   URL of the RDF <rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/library/FA123456.rdf" />
      18     dc:date         Date when search was executed  

    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:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
      xml:lang xml:lang="ja">
      3   title         Feed title Query will come after "CiNii Organization OpenSearch - "
      <title>CiNii Organization OpenSearch - Osaka Kyoiku University</title>
      4   link     href     URL in the case of searching equivalent contents with HTML.
      5   link     ref     Fixed value(self)
      6         type     Fixed value(application/atom+xml)
      7         href   Query URI Encoded query as "parameter=value" and connect by "&amp;".
      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 library search results  
      14     title       Library name  
      15     link   href   Library’s URI Permalink of the library.
      <link href="http://ci.nii.ac.jp/library/FA123456"/>
      16     link   ref     Fixed value(self)
      17         type     Fixed value(application/atom+xml)
      18         href   RDF's URI Displays RDF’s URI. (The parameter of appid is removed.)
      href="http://ci.nii.ac.jp/library/FA123456.rdf"
      19     id       Library's URI Permalink of the library.
      <id>http://ci.nii.ac.jp/library/FA123456</id>
      20     updated       Date when search was executed  

    To top of this page

    Back:CiNii Books OpenSearch for Authors

    Next:CiNii Books OpenSearch for Holdings