CiNii Articles - Metadata and API - CiNii Articles JSON-LD for Articles (Beta)

 

CiNii Articles JSON-LD for Articles 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 asCiNii Articles RDF for Article Information."Article Information (Japanese)" and "Author Information" will be output.
http://ci.nii.ac.jp/naid/<naid>.json (For example: http://ci.nii.ac.jp/naid/110009544496.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 Article Details Page (For example: http://ci.nii.ac.jp/naid/110009544496/en/), 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

 

Article Information

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":{
"rdfs":"http://www.w3.org/2000/01/rdf-schema#",
"dc":"http://purl.org/dc/elements/1.1/",
"dcterms":"http://purl.org/dc/terms/",
"foaf":"http://xmlns.com/foaf/0.1/",
"prism":"http://prismstandard.org/namespaces/basic/2.0/",
"con":"http://www.w3.org/2000/10/swap/pim/contact#",
"cinii":"http://ci.nii.ac.jp/ns/1.0/",
"bibo":"http://purl.org/ontology/bibo/"},
2   rdfs         Required   http://www.w3.org/2000/01/rdf-schema#
3   dc         Required   http://purl.org/dc/elements/1.1/
4   dcterms         Required   http://purl.org/dc/terms/
5   foaf         Required   http://xmlns.com/foaf/0.1/
6   prism         Required   http://prismstandard.org/namespaces/basic/2.0/
7   con         Required   http://www.w3.org/2000/10/swap/pim/contact#
8   cinii         Required   http://ci.nii.ac.jp/ns/1.0/
9   bibo         Required   http://purl.org/ontology/bibo/
10 @id           Required URI of Article bibliography JSON-LD Indicates the URI of Journal bibliography JSON-LD(except parameter of appid)
"@id":"http://ci.nii.ac.jp/naid/1234567890.json",
11 @graph         Array Required   Element count of array is 1
12   @id           URI of Article "#article" is added to URI in Article Details Page
"@id":"http://ci.nii.ac.jp/naid/1234567890#article",
13   @type           The string that represents an article "@type":"bibo:Article",
14   foaf:isPrimaryTopicOf       Object   Description of URI of Article bibliography JSON-LD Indicates the URI of Article bibliography JSON-LD(except parameter of appid)
"foaf:isPrimaryTopicOf":{"@id":"http://ci.nii.ac.jp/naid/1234567890.json"},
15     @id         URI of Article bibliographyJSON-LD  
16   dc:title       Array   Description of title Example:
"dc:title": [
{"@value":"CiNii Articlesのシステムデザインとデータモデル(<特集>データベース構築の今)"},
{"@value":"System design and data modeling of CiNii articles(<Special feature>Database design and construction)",
"@language":"en"}
],
17     @value         Title:Japanese, Title: English  
18     @language         Language of title Title in Japanese― without "@language"
Title in English― with "@language" (Required)en:English
19   dc:creator       Array   Description of Author Indicates role (including "written by").Repeated if there are multiple items.
Example:
"dc:creator": [
[{"@value":"吉田 幸苗"},{"@value":"YOSHIDA Yukinae","@language":"en"}],
[{"@value":"高橋 菜奈子"},{"@value":"TAKAHASHI Nanako","@language":"en"}],
[{"@value":"木下 克之"},{"@value":"KINOSHITA Katsuyuki","@language":"en"}],
[{"@value":"尾城 孝一"},{"@value":"OJIRO Koichi","@language":"en"}]
],
20     @value         Author name:Japanese, Author name:English  
21     @language         Language of Author name Author name:Japanese―without "@language"
Author name:English―with "@language"(Required)en:English
22   dc:publisher       Array   Description of Publisher Repeated if there are multiple items.
Example:
"dc:publisher":[
{"@value":"社団法人人工知能学会"},
{"@value":"The Japanese Society for Artificial Intelligence","@language":"en"}
],
23     @value         Publisher name:Japanese, Publisher name:English  
24     @language         Language of Publisher name Publisher name:Japanese―without "@language"
Publisher name:English―with "@language" (Required)en:English
25   prism:publicationName       Array   Description of Publication name Example:
"prism:publicationName":[
{"@value":"人工知能学会誌"},
{"@value":"Journal of Japanese Society for Artificial Intelligence","@language":"en"}
],
26     @value         Publication name:Japanese, Publication name:English  
27     @language         Language of publication Publication name:Japanese― without "@language"
Publication name:English―with "@language"( Required)en:English
28   prism:issn           ISSN  
29   prism:volume           Volume  
30   prism:number           Number  
31   prism:startingPage           Start page  
32   prism:endingPage           End page  
33   prism:pageRange           Page range  
34   prism:publicationDate           Date of Publication W3CDTF format
35   dc:description       Array   Description of Article abstract Example:
"dc:description":[
{"@value":"[abstract: Japanese]"},
{"@value":"[abstract: English]","@language":"en"}
],
36     @value         Abstract:Japanese, Abstract:English  
37     @language         Language of Abstract Abstract:Japanese― without "@language"
Abstract:English― without "@language"(Required)en:English
38   foaf:topic       Array   Description of Keywords Repeated if there are multiple items.
Example:
"foaf:topic":[
{
"@id":"http://ci.nii.ac.jp/keyword/システムデザイン",
"dc:title":[{"@value":"システムデザイン"}]
},
{
"@id":"http://ci.nii.ac.jp/keyword/検索エンジン",
"dc:title":[{"@value":"検索エンジン"}]
},
{
"@id":"http://ci.nii.ac.jp/keyword/system+design",
"dc:title":[{"@value":"system design","@language":"en"}]
},
{
"@id":"http://ci.nii.ac.jp/keyword/search+engine",
"dc:title":[{"@value":"search engine","@language":"en"}]
}
]
39     @id         URI of Keywords URI for keywords search. If there is a space in character strings of keywords, it will be replaced "+".
40     dc:title     Array      
41       @value       Keywords:Japanese, Keywords:English  
42       @language       Language of Keywords Keywords:Japanese― without "@language"
Keywords:English―with "@language" (Required)en:English
43   dc:date           Date of Publication The same as prism:publicationDate
44   cinii:naid           NAID of Article Article ID for CiNii Articles
45   cinii:ncid           NCID of journals NII bibliography ID (NCID) of journals.
46   cinii:ndljpi           NDLID of Journals Article ID by National Diet Library
47   dc:language           Language code for Full Text  
48   dc:source       Array   Description of data sources Repeated if there are multiple items
Example:
"dc:source":[
{"@value":"NDL"},
{"@value":"NII-ELS"}
],
49     @value     Array   Name of data sources  
50   cinii:references           The number of references  
51   cinii:citedBy           The number of Cited by  
52   dcterms:isPartOf       Object   Description of Incorporated journals Example:
"dcterms:isPartOf":{"@id":"http://ci.nii.ac.jp/ncid/AN10005857#entity","dc:title":"情報の科学と技術"},
53     @id         URI of Incorporated Journals "#entity" is added to URI in CiNii Books details page
54     dc:title         Title of Incorporated Journals  
55   rdfs:seeAlso       Array   Description of External links Repeated if there are multiple items
Example:
"rdfs:seeAlso":[
{"@id":"http://id.ndl.go.jp/bib/025041670",
"dc:title":"NDL-OPAC - 国立国会図書館でさがす"},
{"@id":"http://jlc.jst.go.jp/DN/JST.JSTAGE/johokanri/56.582?from=CiNii",
"dc:title":"J-STAGEで読む・さがす"},
],
56     @id         URL of External links  
57     dc:title         Resource type of External links Institutional Repository, J-STAGE, CrossRef, Ichushi Web, NDL-OPAC and so on
58   prism:doi           DOI  
59   foaf:depiction       Object   Description of Display image for this article Example:
"foaf:depiction":{
"@id":"http://ci.nii.ac.jp/pdfthumbnail/11/1100/110009/110009662002.jpg",
"@type":"foaf:Image"
},
60     @id         Thumbnail URL URL for Full Text thumbnail image in Article details page
61     @type           Fixed: "foaf:Image"
 

Author Information

No. Tag Name Type Required Contents Remarks
First level Second level Third level Fourth level Fifth level Sixth level
62   foaf:maker         Array   Description of Author Repeated for the number of authors
Example:
"foaf:maker": [
{ "@id": "http://ci.nii.ac.jp/nrid/9000002411010#me",
"@type": "foaf:Person",
"foaf:name": [{"@value": "吉田 幸苗"},{"@value": "YOSHIDA Yukinae","@language": "en"}],
"con:organization": [
{
"@id":"http://ci.nii.ac.jp/org/国立情報学研究所学術基盤推進部",
"@type": "foaf:Organization",
"foaf:name": [{"@value": "国立情報学研究所学術基盤推進部"},{"@value": "National Institute of Informatics","@language": "en"}]
}
]
}, {
"@id": "http://ci.nii.ac.jp/nrid/9000002411129#me",
"@type": "foaf:Person",
"foaf:name": [{"@value": "高橋 菜奈子"},{"@value": "TAKAHASHI Nanako","@language": "en"}],
"con:organization": [
{
"@id":"http://ci.nii.ac.jp/org/国立情報学研究所学術基盤推進部",
"@type": "foaf:Organization",
"foaf:name": [{"@value": "国立情報学研究所学術基盤推進部"},{"@value": "National Institute of Informatics","@language": "en"}]
}
]
}
],
63     @id           URI of Author "#me" is added to URI in Author Details Page
64     @type             Fixed:"foaf:Person"
65     foaf:name       Array   Description of Author name  
66       @value         Author name in Japanese, Author name in English  
67       @language         Language of Author name Author name in Japanese ―without "@language"
Author name in English―with "@language"(Required)en:English
68       con:organization     Array   Description of author's Affiliation Repeated if there are multiple affiliations
69         @id       URL of author's Affiliation Indicates URL from the Affiliation name in Japanese
70         @type         Fixed:"foaf:Oragnization"
71         foaf:name   Array   Description of Affiliation name  
72           @value     Affiliation name in Japanese, Affiliation name in English  
73           @language     Language of Affiliation name Affiliation name in Japanese― without "@language"
Affiliation name in English―with "@language"(Required)en:English
 

Revision History

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

June 16, 2017

  • Change the Format Specification.
    • Deleted information representing articles in cinii:fulltext.

March 13, 2015

  • Change the Format Specification.
    • Added information representing articles in @type.
    • Added information representing DOI in prism:doi.

October 15, 2014

  • In "URI of Keywords" (foaf:topic @id) character of replaced has changed from "_" to "+".

October 29, 2013

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