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 | Including role ("by", "translated by" etc.) | ||||||
21 | dc:publisher | Array | Publisher | Repeated if there are multiple items. | |||||
22 | dcterms:extent | Pages/Volumes | |||||||
23 | cinii:size | Size | |||||||
24 | 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). | |||||
25 | dc:date | Publish year | |||||||
26 | cinii:ncid | Required | NII bibliography ID (NCID) | NACSIS-CAT Bibliographic ID | |||||
27 | prism:edition | Edition | |||||||
28 | cinii:ownerCount | Required | Number of Holding libraries | Number of Holding libraries of the book Example: "cinii:ownerCount":"63", |
|||||
29 | dcterms:medium | Object | Description of Media format | Example: "dcterms:medium":{"dc:title":"録音資料(音楽)(CD)"}, |
|||||
30 | dc:title | Required | Media format | ||||||
31 | 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"}]}], |
|||||
32 | @id | Required | URI of Author | "#entity" is added to URI in Author Details Page. | |||||
33 | @type | Required | Fixed:"foaf:Person" | ||||||
34 | foaf:name | Array | Required | Description of Author name | |||||
35 | @value | Required | Author Name, Transcription of Author Name | First name, last name | |||||
36 | @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 | ||||||
37 | 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":"奈良佐保短期大学図書館"}, |
|||||
38 | @id | Required | URI of Holding library Details Page | "#entity" is added to URI in Holding library Details Page. | |||||
39 | @type | Required | Fixed: "foaf:Organization" | ||||||
40 | foaf:name | Required | Name of holding library | ||||||
41 | rdfs:seeAlso | Object | Description of URL for OPAC of holding library | ||||||
42 | @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. | |||||
43 | bibo:lccn | Array | LCCN (Library Congress Control Number of the U.S.) | Repeated if there are multiple items Example: "bibo:lccn":["84009674","82008292"], |
|||||
44 | 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"}], |
|||||
45 | @id | Required | URI of LCCN Permalink | URI of LCCN Permalink page. https://lccn.loc.gov/[LCCN] | |||||
46 | dcterms:hasFormat | Full text link | |||||||
47 | @id | Required | Full text URL | ||||||
48 | dc:title | Volume | |||||||
49 | dc:date | Publish date | |||||||
50 | prism:publicationDate | Array | Date of Publication | ||||||
51 | cinii:note | Array | Note | ||||||
52 | dc:subject | Array | Classification | ||||||
53 | cinii:relation | Array | Permalink of Related Bibliography | ||||||
54 | @id | Required | "#entity" is added to "https://ci.nii.ac.jp/ncid/XX12345678", | ||||||
55 | dc:title | Required | Related Bibliography title | ||||||
56 | cinii:ncid | Related Bibliography ID | Bibliography ID of Related Bibliography | ||||||
57 | 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: 黒い皮ノート","桐の花ノート","三崎ノート"], |
|||||
58 | foaf:topic | Array | Description of Subject | Repeated if there are multiple itemsExample: "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":"インターネット"}], |
|||||
59 | @id | Required | URI of Subject | URI of subject as keyword search | |||||
60 | dc:title | Required | Subject | ||||||
61 | 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"}], |
|||||
62 | @id | Required | URI of Writings in parent bibliography | "#entity" is added to URI in Parent bibliography(series name) | |||||
63 | dc:title | Required | Title of Parent bibliography | Including numbers of series | |||||
64 | @type | Fixed:"bibo:Book" | |||||||
65 | 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巻"}, |
|||||
66 | @id | ISBN | urn:isbn:[ISBN] | ||||||
67 | 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 | Including role ("by", "translated by" etc.) | ||||||
21 | dc:publisher | Array | Publisher | Repeated if there are multiple items. | |||||
22 | dcterms:extent | Pages/Volumes | |||||||
23 | cinii:size | Size | |||||||
24 | 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). | |||||
25 | dc:date | Publish year | |||||||
26 | cinii:ncid | Required | NII bibliography ID (NCID) | NACSIS-CAT bibliographic ID | |||||
27 | prism:edition | Edition | |||||||
28 | cinii:ownerCount | Required | Number of Holding libraries | Number of holding libraries of the journal Example: "cinii:ownerCount":"63", |
|||||
29 | dcterms:medium | Object | Dsscription of Media format | Example: "dcterms:medium":{"dc:title":"録音資料(音楽)(CD)"}, |
|||||
30 | dc:title | Required | Media format | ||||||
31 | 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"}]}], |
|||||
32 | @id | URI of Author | "#entity" is added to URI in Author details page | ||||||
33 | @type | Required | Fixed: "foaf:Person" | ||||||
34 | foaf:name | Array | Required | Description of Author name | |||||
35 | @value | Required | Author Name, Transcription of Author Name | Family name, First name | |||||
36 | @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 | ||||||
37 | 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":"奈良佐保短期大学図書館"}, |
|||||
38 | @id | Required | URI of Holding library Details Page | ||||||
39 | @type | Required | Fixed: "foaf:Organization" | ||||||
40 | foaf:name | Required | Name of holding library | ||||||
41 | rdfs:seeAlso | Object | Description of URL for OPAC of holding library | ||||||
42 | @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. | |||||
43 | bibo:lccn | Array | LCCN (Library Congress Control Number of the U.S.) | Repeated if there are multiple items Example: "bibo:lccn":["84009674","82008292"], |
|||||
44 | 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"}], |
|||||
45 | @id | Required | URI of LCCN Permalink | URI of LCCN Permalink page. https://lccn.loc.gov/[LCCN] | |||||
46 | dcterms:hasFormat | Full text link | |||||||
47 | @id | Required | Full text URL | ||||||
48 | dc:title | Volume | |||||||
49 | dc:date | Publish date | |||||||
50 | cinii:volumeYear | Volume/Year | |||||||
51 | prism:issn | ISSN | |||||||
52 | cinii:familyid | Journal bibliographic history ID | |||||||
53 | 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"}], |
|||||
54 | @id | Required | URI of the previous/following journals | "#entity" is added to URI in Journal bibliography details page | |||||
55 | 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.
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.