Tokyo Museum Collection(ToMuCo) API 仕様

Tokyo Museum Collection(ToMuCo)では、東京都の⽂化施設の所蔵品情報を収集して統合データベースを構築しています。ToMuCoではすべての所蔵品データのメタデータ（所蔵品に関する情報）をオープンデータとして公開しています。以降、データの利⽤⽅法について解説します。

本サイトの概要や利⽤条件については以下のページを参照してください。

データの⼊⼿⽅法

ToMuCoでは次の2つの⽅法でデータを⼊⼿できます。

1. 各所蔵品の詳細ページのメタデータダウンロードボタン
各所蔵品のオープンデータはそれぞれの個別ページからJSON形式でダウンロードできます。

2. 検索API

指定した条件で絞込検索した結果を返却します。検索条件をパラメーターとして付与したGETリクエストを送信してください。JSON形式のデータがレスポンスされます。

API Path

                      
https://museumcollection.tokyo/works/?output=json

パラメーター
パラメーター	説明
keyword	検索キーワードを指定します
artist_name	作家名を指定します
genre	ジャンルを指定します
medium	材質・技法の値を指定します
museums	施設コード表を用い、所蔵品を保持している所蔵館を指定します。値は配列で送信します
production_year_from	制作年を指定します。入力された西暦以降の作品を検索します
production_year_to	制作年を指定します。入力された西暦以前の作品を検索します
limit	取得する件数を指定します。0から1000の間で指定でき、初期値は100です
offset	取得をスキップする数を指定します
output	"json"を指定します

サンプルクエリ(江戸東京博物館の1900年以降の版画を検索)

https://museumcollection.tokyo/works/?genre=block-prints&production_year_from=1900&museums[]=edo-tokyo-museum&output=json

各種コード

ToMuCo内では施設コードを定め、データの中で参照している。検索クエリにも⽤いる。

1. 施設コード
コード	ラベル（日）	IRI
edo-tokyo-museum	江戸東京博物館	https://museumcollection.tokyo/ns/codes/museums#edo-tokyo-museum
topmuseum	東京都写真美術館	https://museumcollection.tokyo/ns/codes/museums#topmuseum
mot-art-museum	東京都現代美術館	https://museumcollection.tokyo/ns/codes/museums#mot-art-museum
tatemonoen	江戸東京たてもの園	https://museumcollection.tokyo/ns/codes/museums#tatemonoen
tobikan	東京都美術館	https://museumcollection.tokyo/ns/codes/museums#tobikan
teien-art-museum	庭園美術館	https://museumcollection.tokyo/ns/codes/museums#teien-art-museum

データ形式

ToMuCoでは、ToMuCoが定める標準項⽬のデータをJSON形式で返却しています。

ToMuCo標準項⽬

ToMuCo標準項⽬とは、ToMuCoがデータ収集対象としている各施設のデータ間で共通化できるデータ項⽬を指します。各施設によるオリジナルデータとToMuCo標準項⽬の対照表を表1に⽰します。

・ここで定める全ての値が揃っていることは保証されません。当該項⽬の値が無い場合は空⽂字列が⼊ります

表1）ToMuCo標準項⽬と各施設によるオリジナルデータ項⽬との対照表

ToMuCo共通項目	江戸東京博物館	東京都写真美術館	東京都現代美術館	江戸東京たてもの園	東京都美術館	庭園美術館
ID	資料番号	作品番号/Art number	収蔵作品番号	資料番号	作品番号	収蔵品No.
作品名	資料名	作品名（和）/Title in Japanese	作品名	建造物名	作品名	作品名
作品名（en）	資料名（英）	作品名（英）/Title in English	作品名英文	Name	作品名（英題）	Title
大分類名	一分類	区分/Category	作品分類		中分類	大分類
中分類名	二分類
制作年	西暦年月日	制作年/Date	制作年	制作年（建築年）	制作年（西暦）	制作年
所蔵館				所蔵館
サイズ（高さ）	寸法_高さ		サイズ（高さ、縦）		寸法（高さ、縦）cm
サイズ（幅）	寸法_横		サイズ（横、幅）		寸法（幅、横）cm
サイズ（奥行）	寸法_縦		サイズ（奥行）		寸法（奥行き）cm
寸法（公開用）		寸法/Size（和）				寸法
収集方法	収集方法	受入方法				収集の方法
作者名	作者名		作家名		作家名	作者名
作者名（en）	作者名（英）		作家名英文		作家名（英語表記）	Artist name
材質・技法		技法/Technique（和）	材質・技法		材質・技法	素材・技法
材質・技法（en）			材質・技法（英文）		材質・技法（英文）
生没年			生没年			生没年
解説	解説	解説（和）		解説

レスポンスデータ

ToMuCo標準項⽬をJSON-LD形式で返却します。データモデルはSchma.orgのCreativeWorkを参照しています。いくつかのクラスがネストされた構造になっています。以降はクラスごとのプロパティとその値の⼀覧になります。

※ JSON-LDとはLinked DataのJSON表現です。詳しくはW3Cのドキュメントをご参照ください
※ Schema.org では多様な概念を対象にデータモデルを策定しています

schema:CreativeWork
プロパティ	値	ToMuCo共通項目
schema:identifier	schema:PropertyValueのArray
schema:genre	skos:ConceptのArray（分野コードを参照）	大分類、中分類
schema:name	literalのArray（対応する言語を言語タグで指定）	作品名、作品名（en）
schema:creator	schema:PersonのArray
schema:size	literalのArray（対応する言語を言語タグで指定）	サイズ（高さ）、サイズ（幅）、サイズ（奥行き）、寸法
schema:dateCreated	4桁の数字	制作年
schema:material	literalのArray（対応する言語を言語タグで指定）	材質・技法、材質・技法（en）
schema:isPartOf	schema:CollectionのArray
dct:provenance	literalのArray（対応する言語を言語タグで指定）	収集方法
schema:description	literalのArray（対応する言語を言語タグで指定）	解説

schema:PropertyValue

ToMuCo ID とaccession numberと2系統のIDがある。 ToMuCo ID はToMuCo内での所蔵品の識別⼦。 accession numberは所蔵館による元データが持っていた識別⼦。
プロパティ	値	ToMuCo共通項目
schema:value	literal（体系の中での識別値）	ID（accession number）
schema:name	literal（IDの体系を指すラベル）

schema:Person
プロパティ	値	ToMuCo共通項目
schema:name	literalのArray（対応する言語を言語タグで指定）	作家名、作家名（en）
schema:birthDate	xsd:date	生没年（生年）
schema:deathDate	xsd:date	生没年（没年）

schema:Collection

所蔵品は必ず所蔵館のコレクションに含まれる。また、所蔵品がシリーズを構成する場合にもschema:Collectionのオブジェクトとして⽰される。
プロパティ	値	ToMuCo共通項目
schema:maintainer	schema:OrganizationのArray
schema:name	literalのArray（対応する言語を言語タグで指定）	所蔵館

schema:Organization
プロパティ	値	ToMuCo共通項目
schema:name	literalのArray（対応する言語を言語タグで指定）	所蔵館

データ例

                  
{
    "@context": {
        "dct": "http://purl.org/dc/elements/1.1/",
        "schema": "http://schema.org/",
        "xsd": "http://www.w3.org/2001/XMLSchema#",
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#"
    },
    "@type": "schema:CreativeWork",
    "@id": "https://museumcollection.tokyo/works/6231143",
    "schema:identifier": [
        {
            "@type": "PropertyValue",
            "schema:name": "ToMuCo ID",
            "schema:value": "6231143"
        },
        {
            "@type": "PropertyValue",
            "schema:name": "accession number",
            "schema:value": "1975-00-0539-000"
        }
    ],
    "schema:genre": [
        {
            "@id": "https://museumcollection.tokyo/ns/codes/genre#絵画",
            "skos:prefLabel": [
                {
                    "@value": "絵画",
                    "@lang": "ja"
                }
            ]
        }
    ],
    "schema:name": [
        {
            "@value": "忙中閑",
            "@lang": "ja"
        },
        {
            "@value": "A Rest During a Busy Day",
            "@lang": "en"
        }
    ],
    "schema:creator": [
        {
            "@type": "schema:Person",
            "schema:name": [
                {
                    "@value": "山本　日子士良",
                    "@lang": "ja"
                },
                {
                    "@value": "YAMAMOTO Hikoshiro",
                    "@lang": "en"
                }
            ],
            "schema:birthDate": [
                {
                    "@type": "xsd:date",
                    "@value": "1907-06-24"
                }
            ],
            "schema:deathDate": [
                {
                    "@type": "xsd:date",
                    "@value": "1946-01-19"
                }
            ]
        }
    ],
    "schema:size": "145.5(高さ、縦)×112.1(幅、横) cm",
    "schema:dateCreated": "1967",
    "schema:material": [
        {
            "@value": "油彩／カンヴァス",
            "@lang": "ja"
        },
        {
            "@value": "Oil on canvas",
            "@lang": "en"
        }
    ],
    "schema:isPartOf": [
        {
            "@type": "schema:Collection",
            "schema:maintainer": [
                {
                    "@type": "schema:Organization",
                    "schema:name": [
                        {
                            "@value": "東京都現代美術館",
                            "@lang": "ja"
                        },
                        {
                            "@value": "Museum of Contemporary Art Tokyo",
                            "@lang": "en"
                        }
                    ]
                }
            ]
        },
        {
            "@type": "schema:Collection",
            "schema:name": [
                {
                    "@value": "コレクション名",
                    "@lang": "ja"
                },
                {
                    "@value": "Collection Name",
                    "@lang": "en"
                }
            ]
        }
    ],
    "dct:provenance": [
        {
            "@value": "寄贈",
            "@lang": "ja"
        }
    ]
}

データの⼊⼿⽅法

各種コード

データ形式

個人情報の取り扱いについて