CiNii Books - Metadata and API - CiNii Books JSON-LD for Books & Journals (Beta)

Contents

 

CiNii Books JSON-LD for Books & Journals Format Specification

Note: This is a Beta version therefore Format Specification may be subject to change hereafter depending on user feedbacks. Please be advised before using.

When you access to the following URI, you can obtain the data with JSON-LD format. What information you can obtain is as the same as "“CiNii Books RDF for Books & Journals". Books Format and Journals Format are different.
https://ci.nii.ac.jp/ncid/<ncid>.json（Example: https://ci.nii.ac.jp/ncid/BB08796640.json）

Content Negotiation is also acceptable. Even if JSON-LD URI is not be specified, JSON-LD will respond by recognition from HTTP header. In the Books & Journals Details Page (For example : https://ci.nii.ac.jp/ncid/BB08796640), specification of "application/json" or "application/ld+json" in accept field of HTTP request header has much priority than any other specifications, it will induce automatically to URI of JSON-LD.

"Access-Control-Allow-Origin*" is required on http header for response, and it is available to use asynchronous communication between cross domains.

 

Format Specification

 

Books JSON-LD

No. Tag Name Type Required Contents Remarks
First level Second level Third level Fourth level Fifth level
1 @context         Object Required Document route element "@context":{
"owl":"http://www.w3.org/2002/07/owl#",
"bibo":"http://purl.org/ontology/bibo/",
"foaf":"http://xmlns.com/foaf/0.1/",
"rdfs":"http://www.w3.org/2000/01/rdf-schema#",
"prism":"http://prismstandard.org/namespaces/basic/2.0/",
"cinii":"http://ci.nii.ac.jp/ns/1.0/",
"dc":"http://purl.org/dc/elements/1.1/",
"dcterms":"http://purl.org/dc/terms/"
},
2   owl         Required   http://www.w3.org/2002/07/owl#
3   bibo         Required   http://purl.org/ontology/bibo/
4   foaf         Required   http://xmlns.com/foaf/0.1/
5   rdfs         Required   http://www.w3.org/2000/01/rdf-schema#
6   prism         Required   http://prismstandard.org/namespaces/basic/2.0/
7   cinii         Required   http://ci.nii.ac.jp/ns/1.0/
8   dc         Required   http://purl.org/dc/elements/1.1/
9   dcterms         Required   http://purl.org/dc/terms/
10 @id           Required URI of Book bibliography JSON-LD Indicates the URI of Book bibliography JSON-LD (except parameter of appid）
"@id":"https://ci.nii.ac.jp/ncid/XX12345678.json",
11 @graph         Array Required   Element count of array is 1
12   @id         Required URI of Book "#entity" is added to URI in Books Details Page
"@id":"https://ci.nii.ac.jp/ncid/XX12345678#entity",
13   @type         Required The string that represents a book "@type":"bibo:Book",
14   foaf:isPrimaryTopicOf       Object Required Descriptionof URI of Books bibliography JSON-LD Indicates the URI of Books bibliography JSON-LD (except parameter of appid)
"foaf:isPrimaryTopicOf":{"@id":"https://ci.nii.ac.jp/ncid/XX12345678.json"},
15     @id       Required URI of Books bibliography JSON-LD  
16   dc:title       Array Required Descriptionof Title Example:
"dc:title":[
{"@value":"Linked data : webをグローバルなデータ空間にする仕組み"},
{"@value":"Linked data : web オ グローバルナ データ クウカン ニ スル シクミ",
"@language":"ja-hrkt"}
],
17     @value       Required Book title, Title Transcription  
18     @language         Language code of the Title Transcription Book title―without "@language", Title Transcription―with "@language" Required. ko：Korean or ja-hrkt：Japanese transcription
19   dcterms:alternative       Array   Other title Repeated if there are multiple items.
20   dc:creator           Responsibility Publisher Role（Including "written by", etc.)
21   dc:publisher       Array   Publisher Repeated if there are multiple items.
22     @value         Publisher name
23     cinii:publisherRole         Publisher Role Output 4 values below
distribution
manufacture
production
copyright_notice_date
24   dcterms:extent           Pages/Volumes  
25   cinii:size           Size  
26   dc:language         Required Language code of the text Code of the language in which the body text is written. You can find the code at Language code table (Written in Japanese).
27   dc:date           Publish year  
28   cinii:ncid         Required NII bibliography ID (NCID) NACSIS-CAT Bibliographic ID
29   prism:edition           Edition  
30   cinii:ownerCount         Required Number of Holding libraries Number of Holding libraries of the book
Example:
"cinii:ownerCount":"63",
31   dcterms:medium       Object   Description of Media format Example:
"dcterms:medium":{"dc:title":"録音資料（音楽）(CD)"},
32     dc:title       Required Media format  
33   foaf:maker       Array   Description of Author Example:
"foaf:maker":
[{"@id":"https://ci.nii.ac.jp/author/DA15839119#entity","@type":"foaf:Person","foaf:name":[{"@value":"大向, 一輝"},{"@value":"オオムカイ, イッキ","@language":"ja-hrkt"}]},
{"@id":"https://ci.nii.ac.jp/author/DA1649123X#entity","@type":"foaf:Person","foaf:name":[{"@value":"池谷, 瑠絵"},{"@value":"イケヤ, ルエ","@language":"ja-hrkt"}]}],
34     @id       Required URI of Author "#entity" is added to URI in Author Details Page.
35     @type       Required   Fixed："foaf:Person"
36     foaf:name     Array Required Description of Author name  
37       @value     Required Author Name, Transcription of Author Name First name, last name
38       @language       Language code of Transcription of Author Name Author Name―without "@language", Transcription of Author Name―with "@language" Required. ko：Korean or ja-hrkt：Japanese transcription
39   bibo:owner       Array   Description of holding library Example:
"bibo:owner":
[{"@id":"https://ci.nii.ac.jp/library/FA008006","@type":"foaf:Organization","foaf:name":"関西外国語大学 図書館","rdfs:seeAlso":{"@id":"http://opac.kansaigaidai.ac.jp/webopac/ctlsrh.do?ncid=BB08796640"}},
{"@id":"https://ci.nii.ac.jp/library/FA022878","@type":"foaf:Organization","foaf:name":"奈良佐保短期大学図書館"},
40     @id       Required URI of Holding library Details Page "#entity" is added to URI in Holding library Details Page.
41     @type       Required   Fixed: "foaf:Organization"
42     foaf:name       Required Name of holding library  
43     rdfs:seeAlso     Object   Description of URL for OPAC of holding library  
44       @id     Required OPAC URL URL to link the page of the book in OPAC of the library. URL is specified to the books by NCID.
45   bibo:lccn       Array   LCCN (Library Congress Control Number of the U.S.) Repeated if there are multiple items
Example:
"bibo:lccn":["84009674","82008292"],
46   rdfs:seeAlso       Array   Description of LCCN Permalink Repeated if there are multiple items
Example:
"rdfs:seeAlso":[{"@id":"https://lccn.loc.gov/84009674"},
{"@id":"https://lccn.loc.gov/82008292"}],
47     @id       Required URI of LCCN Permalink URI of LCCN Permalink page. https://lccn.loc.gov/[LCCN]
48   dcterms:hasFormat           Full text link  
49     @id       Required Full text URL  
50     dc:title         Volume  
51     dc:date         Publish date  
52   prism:publicationDate       Array   Date of Publication  
53   cinii:note       Array   Note  
54   dc:subject       Array   Classification  
55   cinii:relation       Array   Permalink of Related Bibliography  
56     @id       Required   "#entity" is added to "https://ci.nii.ac.jp/ncid/XX12345678",
57     dc:title       Required   Related Bibliography title
58     cinii:ncid         Related Bibliography ID Bibliography ID of Related Bibliography
59   cinii:contentOfWorks       Array   Note for Content of works Description of Contents of unit works in structural parts of the book
Example:
"cinii:contentOfWorks":["1: 邪宗門ノート","思ひ出ノート","2: 黒い皮ノート","桐の花ノート","三崎ノート"],
60   foaf:topic       Array   Description of Subject Repeated if there are multiple items
Example:
"foaf:topic":[{"@id":"https://ci.nii.ac.jp/books/search?q=%E6%83%85%E5%A0%B1%E5%8C%96%E7%A4%BE%E4%BC%9A","dc:title":"情報化社会"},
{"@id":"https://ci.nii.ac.jp/books/search?q=%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%8D%E3%83%83%E3%83%88","dc:title":"インターネット"}],
61     @id       Required URI of Subject URI of subject as keyword search
62     dc:title       Required Subject  
63   dcterms:isPartOf       Array   Description of Parent Bibliography Repeated if there are multiple Parent bibliographies(series name).
Example:
"dcterms:isPartOf":[{"@id":"https://ci.nii.ac.jp/ncid/BN06190301#entity","dc:title":"丸善ライブラリー, 381 . 情報研シリーズ||ジョウホウケン シリーズ ; 15"}],
64     @id       Required URI of Writings in parent bibliography "#entity" is added to URI in Parent bibliography(series name)
65     dc:title       Required Title of Parent bibliography Including numbers of series
66     @type           Fixed:"bibo:Book"
67   dcterms:hasPart       Array   Description about volumes of the book Repeated if there are multiple items.
Example:
"dcterms:hasPart":[{"@id":"urn:isbn:4642005013","dc:title":"第1巻"},
68     @id         ISBN urn:isbn:[ISBN]
69     dc:title         Volume/Number  
 

Journals JSON-LD

No. Tag name Type Required Contents Remarks
First level Second level Third level Fourth level Fifth level
1 @context         Object Required Document route element "@context":{
"owl":"http://www.w3.org/2002/07/owl#",
"bibo":"http://purl.org/ontology/bibo/",
"foaf":"http://xmlns.com/foaf/0.1/",
"rdfs":"http://www.w3.org/2000/01/rdf-schema#",
"prism":"http://prismstandard.org/namespaces/basic/2.0/",
"cinii":"http://ci.nii.ac.jp/ns/1.0/",
"dc":"http://purl.org/dc/elements/1.1/",
"dcterms":"http://purl.org/dc/terms/"
},
2   owl         Required   http://www.w3.org/2002/07/owl#
3   bibo         Required   http://purl.org/ontology/bibo/
4   foaf         Required   http://xmlns.com/foaf/0.1/
5   rdfs         Required   http://www.w3.org/2000/01/rdf-schema#
6   prism         Required   http://prismstandard.org/namespaces/basic/2.0/
7   cinii         Required   http://ci.nii.ac.jp/ns/1.0/
8   dc         Required   http://purl.org/dc/elements/1.1/
9   dcterms         Required   http://purl.org/dc/terms/
10 @id           Required URI of Journal bibliography JSON-LD Indicates the URI of Journal bibliography JSON-LD (except parameter of appid)
"@id":"https://ci.nii.ac.jp/ncid/XX12345678.json",
11 @graph         Array Required   Element count of array is 1
12   @id         Required URI of Book bibliography JSON-LD "#entity" is added to URI in Journal Details Page
"@id":"https://ci.nii.ac.jp/ncid/XX12345678#entity",
13   @type         Required The string that represents a book "@type":"bibo:Book",
14   foaf:isPrimaryTopicOf       Object Required Description of URI of Journal bibliography JSON-LD Indicates the URI of Journal bibliography JSON-LD (except parameter of appid)
"foaf:isPrimaryTopicOf":{"@id":"https://ci.nii.ac.jp/ncid/XX12345678.json"},
15     @id       Required URI of Journal bibliography JSON-LD  
16   dc:title       Array Required Description of Journal Title Example:
"dc:title":
[{"@value":"情報処理学会論文誌"},
{"@value":"ジョウホウ ショリ ガッカイ ロンブンシ","@language":"ja-hrkt"}],
17     @value       Required Journal Title, Title Transcription  
18     @language         Language code of the Title Transcription Journal title―without "@language", Title Transcription―with "@language" Required. ko：Korean or ja-hrkt：Japanese transcription
19   dcterms:alternative       Array   Other title Repeated if there are multiple items.
20   dc:creator           Responsibility Publisher Role（Including "written by", etc.)
21   dc:publisher       Array   Publisher Repeated if there are multiple items.
22     @value         Publisher name
23     cinii:publisherRole         Publisher Role Output 4 values below
distribution
manufacture
production
copyright_notice_date
24   dcterms:extent           Pages/Volumes  
25   cinii:size           Size  
26   dc:language         Required Language code of the text Code of the language in which the body text is written. You can find the code at Language code table (Written in Japanese).
27   dc:date           Publish year  
28   cinii:ncid         Required NII bibliography ID (NCID) NACSIS-CAT bibliographic ID
29   prism:edition           Edition  
30   cinii:ownerCount         Required Number of Holding libraries Number of holding libraries of the journal
Example:
"cinii:ownerCount":"63",
31   dcterms:medium       Object   Dsscription of Media format Example:
"dcterms:medium":{"dc:title":"録音資料（音楽）(CD)"},
32     dc:title       Required Media format  
33   foaf:maker       Array   Description about author Example:
"foaf:maker":
[{"@id":"https://ci.nii.ac.jp/author/DA15839119#entity","@type":"foaf:Person","foaf:name":[{"@value":"大向, 一輝"},{"@value":"オオムカイ, イッキ","@language":"ja-hrkt"}]},
{"@id":"https://ci.nii.ac.jp/author/DA1649123X#entity","@type":"foaf:Person","foaf:name":[{"@value":"池谷, 瑠絵"},{"@value":"イケヤ, ルエ","@language":"ja-hrkt"}]}],
34     @id         URI of Author "#entity" is added to URI in Author details page
35     @type       Required   Fixed: "foaf:Person"
36     foaf:name     Array Required Description of Author name  
37       @value     Required Author Name, Transcription of Author Name Family name, First name
38       @language       Language code of Transcription of Author Name Author Name―without "@language", Transcription of Author Name―with "@language" Required. ko：Korean or ja-hrkt：Japanese transcription
39   bibo:owner       Array   Description of Holding library Example:
"bibo:owner":
[{"@id":"https://ci.nii.ac.jp/library/FA008006","@type":"foaf:Organization","foaf:name":"関西外国語大学 図書館","rdfs:seeAlso":{"@id":"http://opac.kansaigaidai.ac.jp/webopac/ctlsrh.do?ncid=BB08796640"}},
{"@id":"https://ci.nii.ac.jp/library/FA022878","@type":"foaf:Organization","foaf:name":"奈良佐保短期大学図書館"},
40     @id       Required URI of Holding library Details Page  
41     @type       Required   Fixed: "foaf:Organization"
42     foaf:name       Required Name of holding library  
43     rdfs:seeAlso     Object   Description of URL for OPAC of holding library  
44       @id     Required OPAC URL URL to link the page of the journal in OPAC of the library. URL is specified to the books by NCID.
45   bibo:lccn       Array   LCCN (Library Congress Control Number of the U.S.) Repeated if there are multiple items
Example:
"bibo:lccn":["84009674","82008292"],
46   rdfs:seeAlso       Array   Description of LCCN Permalink Repeated if there are multiple items
Example:
"rdfs:seeAlso":[{"@id":"https://lccn.loc.gov/84009674"},
{"@id":"https://lccn.loc.gov/82008292"}],
47     @id       Required URI of LCCN Permalink URI of LCCN Permalink page. https://lccn.loc.gov/[LCCN]
48   dcterms:hasFormat           Full text link  
49     @id       Required Full text URL  
50     dc:title         Volume  
51     dc:date         Publish date  
52   cinii:volumeYear           Volume/Year  
53   prism:issn           ISSN  
54   cinii:familyid           Journal bibliographic history ID  
55   dc:relation       Array   Description of the bibliographic history Example:
"dc:relation":
[{"@id":"https://ci.nii.ac.jp/ncid/AA00700121#entity","dc:title":"Journal of information processing / Information Processing Society of Japan"},
{"@id":"https://ci.nii.ac.jp/ncid/AA12317677#entity","dc:title":"情報処理学会論文誌 : 論文誌ジャーナル / 情報処理学会 = IPSJ journal / Information Processing Society of Japan"}],
56     @id       Required URI of the previous/following journals "#entity" is added to URI in Journal bibliography details page
57     dc:title       Required Title of the previous/following journals  
 

Revision History

You can check revision history of CiNii Articles JSON-LD API for Articles later April, 2013.

November 11, 2024

  • Change the Format Specification.
    • Added Publisher Role in cinii:publisherRole

August 21, 2020

  • Change the Format Specification.
    • Added Related Bibliography in cinii:relation. (only Books RDF)

August 17, 2017

  • Change the Format Specification.
    • Added Full text link in dcterms:hasFormat.
    • Delete owl:sameAs. (only Journals RDF)

Nobember 5, 2015

  • Change the Format Specification.
    • Added Pages/Volumes in dcterms:extent.
    • Added Size in cinii:size.

March 13, 2015

  • Change the Format Specification.
    • Added information representing articles in @type.

October 15, 2014

  • " The following functions have been added to the Format Specification
    • LCCN(Library of Congress Control Number)(bibo:lccn)
    • Description of LCCN Permalink (URI is described by http://lccn.loc.gov/[LCCN] with rdfs:seeAlso)

October 11, 2013

  • It has been available to use asynchronous communication between cross domains.
  • CiNii Articles JSON-LD of API for Articles (Beta) has been available.