JSON-LD in CiNii Research

Table of Contents

 

CiNii Research’s Format Specification for JSON-LD

You can obtain the data in JSON-LD format by accessing the URI in the following format. The information you can get is the same a CiNii Research RDF.
https://cir.nii.ac.jp/crid/<crid>.json (E.g. https://cir.nii.ac.jp/crid/1390006432294648704.json）

It supports content negotiation and returns JSON-LD based on the HTTP header even if the JSON-LD URI is not specified. In the details display screen (e.g. https://cir.nii.ac.jp/crid/1390006432294648704), it directs to the JSON-LD URI if the specification of " application/json” or “application/ld+json " in the Accept field of the HTTP request header has a higher priority than any other specification.

You can use cross-domain asynchronous communication by specifying "Access-Control-Allow-Origin:*" in the http header of the response.

 

Format Specification

No. Item Multiplicity Value type Remarks
First leve Second level Third level Fourth level
@context "@context":{
"@vocab":"https://cir.nii.ac.jp/schema/1.0/",
"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/",
"cinii":"http://ci.nii.ac.jp/ns/1.0/",
"datacite":"https://schema.datacite.org/meta/kernel-4/",
"ndl":"http://ndl.go.jp/dcndl/terms/",
"jpcoar":"https://github.com/JPCOAR/schema/blob/master/1.0/"
},
1 Local Identifier @id 1 String An ID that uniquely identifies the object within CiR. Do not use this ID for linking with other objects, but use the Product Identifier.
Data Type @type 1 String Project
Researcher
Article
Book
Dissertation
Dataset
Product (type unknown)
2 Project Identifier projectIdentifier 0..n array The identifier of the project defined externally. Currently, it is KAKEN Research Project/Area Number.
Identifier Type @type 1 String A type that indicates where the identifier is assigned. Currently it is only for kakenhi.
Code Value @value 1 String Identifier
3 Person Identifier personIdentifier 0..n array
Identifier Type @type 1 String ORCID, ISNI, Researcher Resolver ID (NRID) code are assumed.
Code Value @value 1 String
4 Product Identifier productIdentifier 0..n array An identifier used to link or identify with other objects. Used as a pair of identifier type and notation string. DOIs and NAIDs on the same list are considered the same product.
identifier
Identifier Type @type 1 String DOI, URL, NAID, NRID, PMID, PMCID, etc. are assumed.
The URL for each @type is as follows.

  • "@type":"ARK" -> [@value]
  • "@type":"ARXIV" -> https://arxiv.org/abs/[@value]
  • "@type":"BIBCODE" -> http://adsabs.harvard.edu/abs/[@value]
  • "@type":"CODEN" -> URL cannot be generated
  • "@type":"COI" -> URL cannot be generated
  • "@type":"DOI" -> https://doi.org/[@value]
  • "@type":"EAN13" -> URL cannot be generated
  • "@type":"EISSN" -> URL cannot be generated
  • "@type":"HANDLE" -> http://hdl.handle.net/[@value]
  • "@type":"HDL" -> [@value]
  • "@type":"IGSN" -> http://igsn.org/[@value]
  • "@type":"ISBN" -> URL cannot be generated
  • "@type":"ISSN" -> URL cannot be generated
  • "@type":"JST" -> URL cannot be generated
  • "@type":"LCCN" -> URL cannot be generated
  • "@type":"LISSN" -> URL cannot be generated
  • "@type":"LOCAL" -> URL cannot be generated
  • "@type":"LSID" -> http://www.lsid.info/[@value]
  • "@type":"MRID" -> URL cannot be generated
  • "@type":"NAID" -> https://ci.nii.ac.jp/naid/[@value]?l=[selected language]
  • "@type":"NCID" -> https://ci.nii.ac.jp/ncid/[@value]?l=[selected language]
  • "@type":"NDL_BIB_ID" -> https://id.ndl.go.jp/bib/[@value]
  • "@type":"PISSN" -> URL cannot be generated
  • "@type":"PMCID" -> https://www.ncbi.nlm.nih.gov/pmc/articles/[@value]
  • "@type":"PMID" -> https://www.ncbi.nlm.nih.gov/pubmed/[@value]
  • "@type":"PURL" -> [@value]
  • "@type":"SCOPUS" -> URL cannot be generated
  • "@type":"UPC" -> URL cannot be generated
  • "@type":"URI" -> [@value]
  • "@type":"URL" -> [@value]
  • "@type":"W3ID" -> URL cannot be generated
  • "@type":"WOS" -> URL cannot be generated
Code Value @value 1 String
Extended Items extra Book volume number, full-text data links for journals
type Books: "volume number" is "title"
Journal: "volume (issue)" is "title", "publishing date" is "date"
value Enter the value of "volume number", "volume (issue)" or "publishing date" of the data source
5 Resource Type resourceType 1 String Dissertations, bookS, bibliography, conference presentationS, research data, software, etc.
6 Title dc:title 1..l Array The title of the research project.
Title（Project） jpcoar:awardTitle 1..l array The title of the research project.
Language @language 0,1 String
Notation String @value 1 String
dcterms:alternative 1..l Array
@language 0,1 String
@value 1 Array
7 Name foaf:Person 0..n Array
Notation foaf:name 1..l (l = Number of Languages) Array
Language @language 0,1 String
Notation String @value 1 String
Family Name foaf:familyName 0..l (l = Number of Languages) Array
Language @language 0,1 String
Notation @value 1 String
Given Name foaf:givenName 0..l (l = Number of Languages) Array
Language @language 0,1 String
Notation @value 1 String
Middle Name foaf:middleName 0..l (l = Number of Languages) Array
Language @language 0,1 String
Notation @value 1 String
8 Affiliation career 0..n Array
Affiliation Institution institution 0,1 Object
Institution Identifier institutionIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Notation notation 0..n Array
Language @language 0,1 String
Notation @value 1 String
Department department 0,1 Object
Department Identifier departmentIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Notation notation 0..n Array
Language @language 0,1 String
Notation @value 1 String
Job Title jobTitle 0,1 Object
Job title Identifier jobTitleIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Notation notation 0..n Array
Language @language 0,1 String
Notation String @value 1 String
Start Date since 0,1 String W3CDTF notation (YYYY-MM-DD)
End Date until 0,1 String W3CDTF notation (YYYY-MM-DD)
9 Review Section / Research Field field 0..n Array
Keyword keyword 0..n Array
Language language 0,1 String
Notation String textList 1..n (n = Number of Keyword) Array
10 Language dc:language 0,1 String
11 Abstract description 0..n Array
Abstract Type type 0,1 String
Notation notation 1..n Array
Language @language 0,1 String
Notation @value 1 String
Abstract License Flag abstractLicenseFlag @value 0,1 String Set allow / disallow as value if value exists
12 Researcher researcher 0..n (n = Number of Researchers) Array Information on researchers involved in the research
@id 1 String
@type 1 String
Person Identifier personIdentifier 0..n Array This identifier indicates that it is linked to the person schema.
Person Identifier Type @type 1 String The type of identifier. NRID, ORCID, etc.
Code Value @value 1 String
Name name 1..n Array The name of the researcher displayed in the project. One for each language.
Language @language 0,1 String
Notation String @value 1 String
Affiliation affiliation 0..n Array The affiliation of the researcher displayed in the project. One for each language.
Language @language 0,1 String
Notation String @value 1 String
Role in the Research role 0,1 String Role in the research. Principal investigator, Co-Investigator (Kenkyū-buntansha), etc.
13 Start Date since 0,1 String W3CDTF notation (YYYY-MM-DD), project start date
14 End Date until 0,1 String W3CDTF notation (YYYY-MM-DD). project end date (or planned end date)
15 Research Institution institution 1..l (l = Number of Languages) Array Research institution that carries out the project (funded institution). One for each language.
Research Institution Identifier institutionIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Notation notation 0..n Array
Language @language 0,1 String
Notation String @value 1 String
16 Funding Agency fundingProgram 0..n Array
Notation notation 0..n Array
Language @language 0,1 String
Notation String @value 1 String
17 Author creator 0..n (n = Number of Authors) Array Information about the creator of the product
@id 1 String
@type 1 String
Person Identifier personIdentifier 0..n Array This identifier indicates that it is linked to the person schema.
Person Identifier Type @type 1 String
Code Value @value 1 String
Name foaf:name 1..n Array The name of the researcher displayed in the product. One for each language.
Language @language 0,1 String
Notation String @value 1 String
Affiliation jpcoar:affiliationName 0..n Array The affiliation of the researcher displayed in the product. One for each language.
Language @language 0,1 String
Notation @value 1 String
Role in the Research role 0,1 String Role in the product. Author, contributor, etc.
18 Contributor contributor 0..n (n = number of contributors) Array nformation about the contributor of the product
@id 1 String
@type 1 String
Person Identifier personIdentifier 0..n Array This identifier indicates that it is linked to the person schema.
Person Identifier Type @type 1 String The type of identifier. NRID, ORCID, etc.
Code Value @value 1 String
Name foaf:name 1..n Array The name of the contributor displayed in the product. One for each language.
Language @language 0,1 String
Notation String @value 1 String
Affiliation jpcoar:affiliationName 0..n Array The affiliation of the contributor displayed in the deliverable. One for each language.
Language @language 0,1 String
Notation String @value 1 String
Role in the Research role 0,1 String Role in the product. Author, contributor, etc.
19 Journal Articles Publication publication 0,1 Object
Publication Identifier publicationIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Publication Name prism:publicationName 0..l (l = Number of Languages) Array Output only the main title
Language @language 0,1 String
Notation String @value 1 String
Publisher dc:publisher 0..n Array
Language @language 0,1 String
Notation String @value 1 String
Publication Date prism:publicationDate 0,1 String W3CDTF notation (YYYY-MM-DD)
Volume prism:volume 0,1 String
Number prism:number 0,1 String
Starting Page prism:startingPage 0,1 String
End Page prism:endingPage 0,1 String
Total Number of Pages jpcoar:numPages 0,1 String
International Journal foreign 0,1 String Boolean
International Joint Paper jointInternationalResearch 0,1 String Boolean
Peer Review reviewed 0,1 String Boolean
Open access dcterms:accessRights 0,1 String Boolean
20 Dissertatio Degree Award Number ndl:dissertationNumber 0,1 String
Degree Award Date ndl:dateGranted 0,1 String W3CDTF notation (YYYY-MM-DD)
Degree Title ndl:degreeName 0,1 String
Degree-Granting University degreeAwardInstitution 0,1 Object
Institution Identifier institutionIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Notation jpcoar:degreeGrantorName 0..n Array
Language @language 0,1 String
Notation String @value 1 String
21 Presentations and Conference Proceedings Name of Conference jpcoar:conferenceName 0,1 String
Place of Conference jpcoar:conferencePlace 0,1 String
Period of Conference (Start Date) jpcoar:conferenceDate 0,1 Object W3CDTF notation (YYYY-MM-DD)
jpcoar:startDay
jpcoar:startMonth
jpcoar:startYear
Period of Conference (End Date) jpcoar:endDay W3CDTF notation (YYYY-MM-DD)
jpcoar:endMonth
jpcoar:endYear
Conference Organizer jpcoar:conferenceSponsor 0,1 String
Invitation invited 0,1 String Boolean
22 Books Edition prism:edition 0,1 String
Printing printing 0,1 String
Publication Date dc:date 0,1 String W3CDTF notation (YYYY-MM-DD)
dcterms:medium 0,1 Object
General Material Designation Code generalMaterialDesignationCode 0,1
Specific Material Designation Code specificMaterialDesignationCode 0,1
Statement of Responsibility dc:creator 0,1
Publication Country Code publicationCountryCode 0,1
Bibliographic Information/td> dcterms:publisher 0..n Array
Publisher dc:publisher 0,1
Publication Place publicationPlace 0,1
Notation Publication Date/td> prism:publicationDate 0,1
Classification dc:subject 0..n Array
Classification Method (value) 1 String
Classification Code (value) 1 String
Size cinii:size 0,1 String
Number of Pages dcterms:extent 0,1 String
Publication Status Code publicationStatusCode
Publication Frequency Code publicationPeriodicityCode
Publication Regularity Code publicationRegularityCode
Periodical Type Code serialsTypeCode
23 Size jpcoar:extent 0..n Array Dataset size (byte, page, record, etc., including units)
24 Format format 0..n Array PDF, CSV, Excel, JPEG, etc.
25 Version datacite:version 0,1 String
26 Copyright dc:rights 0..n Array Copyright and License Terms (Apache License, GPL, Creative Commons, etc.)
27 URL url 0..n Array Link to the projects.
KAKEN permalink
Link to the products
Notation notation 0..n Array
Language @language 0,1 String
Notation String @value 1 String
URL String @id 1 String
28 Release Date createdAt W3CDTF notation (YYYY-MM-DD)
29 Last Update Data modifiedAt W3CDTF notation (YYYY-MM-DD)
30 Keyword foaf:topic 0..n Array Search words related to the project (e.g. words that do not appear in the title or abstract, but you wish the search to return the results). Multiple keywords for each language.
@id
Notation String dc:title 1..n (n = number of keywords) Array One or more keyword strings. Empty lists are not allowed.
Subject dcterms:subject 0,1
Subject Type Code subjectScheme 1
Notation notation 1..l (l = Number of Languages)
Language @language 1
Notation String @value 1
31 Notes cinii:note 0..n Array Use if there is anything to be noted. One for each language.
Language @language 0,1 String
Notation String @value 1 String
32 Project project 0..n (n = Number of Projects) Array Research involved as a member, principal investigator, and other roles.
@id 1 String
@type 1 String
Project Identifier projectIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Project Notation notation 1..l (l = Number of Languages) Array
Language @language 0,1 String
Notation String @value 1 String
Role in the Research role 0,1 String
33 Related Project relatedProject 0..n Array
@id 1 String
@type 1 String
Project Identifier projectIdentifier 0..n Array
Identifier Type @type 1 String "KAKEN"
Code Value @value 1 String //parentAward/@id
Relation to the Research relationType 0,1 String "isPartOf"
Project Notation notation 0..n Array
Language @language 0,1 String //parentAward/title/@xml:lang
Notation String @value 1 String //parentAward/title/text()
34 Product product 0..n (n = number of products) Array Products produced from the project Products (articles, books, research data, etc.) created as an author, creator, and other roles
@id 1 String
Data Type @type 1 String Article
Book
Dissertation
Dataset
Products (type unknown)
Product Resource Type resourceType 1 String It indicates the type of product.
Articles, conference presentations, books, data, etc.
Product Identifier productIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Product Notation notation 1..l (l = Number of Languages) Array
Language @language 0,1 String
Notation String @value 1 String
Relation Type to the Product relation 0..n Only if it is a person
type 1
detail 0..1
35 Related Product relatedProduct 0..n Array
@id 1 String
Data Type @type 1 String Article
Book
Dissertation
Dataset
Product (type unknown)
Product Identifier productIdentifier 0..n Array
Identifier Type @type 1 String
Code Value @value 1 String
Product Resource Type resourceType 1 String
Relation to the Product relationType 1..n Array References, usage data, citations, etc.
Title jpcoar:relatedTitle 1..l (l = Number of Languages) Array
Language @language 0,1 String
Notation String @value 1 String
36 Data Source Identifier dataSourceIdentifier 1..n(n = Number of Integrated Data) Array ID of the integrated data source
Identifier Type @type 1 String Indicates the data source type
Code Value @value 1 String Identifier
37 Table of Contents dcterms:tableOfContents 0..l (l = Number of Languages) Array Table of contents
Language language 0,1 String
Notation String dcterms:title 1..n (n = Number of Table of Contents Elements) Array One or more strings of table of contents elements. Empty lists are not allowed.
38 Grant grant 0,1 KAKEN Research Fields
Grant Identifier grantIdentifier 0..n
Identifier Type @type 1
Code value @value 1
Notation jpcoar:fundingStream 0..l
Language @language 0,1 Conforms to ISO639-1, plus "ja-Kana" for katakana
Notation Strings @value 1
39 Allocation Classification allocationClassification 0..n KAKEN Specialized Item
Notation notation 1..l
Language @language 0,1 Conforms to ISO639-1, plus "ja-Kana" for katakana
Notation Strings @value 1
40 Allocation Amount allocationClassification 0..n KAKEN Allocation Amount
Total Cost totalCost 1
Amount amount 1
Unit unit 0,1
Currency currency 1
BreakdownCost breakdownCost 0..n KAKEN's direct and indirect costs
Notation notation 1..l
Language @language 1 Conforms to ISO639-1, plus "ja-Kana" for katakana
Notation Strings @value 0,1
Amount amount 1
Unit unit 0,1
Currency currency 1
 

Revision History

You can check the revision history as follows.

　　

Updated on June 26, 2023

Added No.6 "Title（Project）", No.38～40

　　

Updated on January 18, 2023

Deleted Title Type, Title Notation in Title and Language in Keyword, and changed the layout of the table

Updated on August 23, 2022

Added Abstract License Flag

Updated on March 29, 2022

Added how to create URL for each Identifier Type of Product Identifier

Updated on February 1, 2022

Changed the URL to reflect display language parameterization

Created on October 4, 2021