大都会艺术博物馆API

接入教程

1. 访问官方网站查看API文档
2. 注册获取API密钥或直接使用公开端点
3. 通过HTTP请求调用藏品搜索接口
4. 解析返回的JSON格式数据
5. 根据需要处理图像链接和元数据
6. 遵循使用条款合理调用接口

使用Python获取艺术品信息

python

import requests

# 获取指定艺术品ID的详细信息
artwork_id = 436535
url = f'https://collectionapi.metmuseum.org/public/collection/v1/objects/{artwork_id}'

response = requests.get(url)
if response.status_code == 200:
    data = response.json()
    print(f"标题: {data.get('title')}")
    print(f"艺术家: {data.get('artistDisplayName')}")
    print(f"创作年代: {data.get('objectDate')}")
else:
    print(f"请求失败，状态码: {response.status_code}")

使用PHP搜索博物馆藏品

php

<?php
// 根据关键词搜索藏品
$keyword = 'Van Gogh';
$url = 'https://collectionapi.metmuseum.org/public/collection/v1/search?q=' . urlencode($keyword);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

if ($response) {
    $data = json_decode($response, true);
    if (isset($data['objectIDs'])) {
        echo "找到 " . count($data['objectIDs']) . " 件相关藏品\n";
        echo "前5件藏品ID: " . implode(', ', array_slice($data['objectIDs'], 0, 5));
    } else {
        echo "未找到相关藏品";
    }
} else {
    echo "请求失败";
}
?>

使用JavaScript获取藏品图像

javascript

// 获取指定部门的最新藏品（包含图像信息）
const departmentId = 11; // 欧洲绘画部门
const url = `https://collectionapi.metmuseum.org/public/collection/v1/objects?departmentIds=${departmentId}&hasImages=true`;

fetch(url)
    .then(response => response.json())
    .then(data => {
        if (data.objectIDs && data.objectIDs.length > 0) {
            // 获取第一件藏品的详细信息
            const firstObjectId = data.objectIDs[0];
            return fetch(`https://collectionapi.metmuseum.org/public/collection/v1/objects/${firstObjectId}`);
        }
        throw new Error('未找到包含图像的藏品');
    })
    .then(response => response.json())
    .then(artwork => {
        console.log('艺术品标题:', artwork.title);
        console.log('主图像URL:', artwork.primaryImage);
        console.log('小图URL:', artwork.primaryImageSmall);
    })
    .catch(error => console.error('错误:', error.message));

常见问题

API是否需要认证或API密钥？

大都会艺术博物馆API是完全免费的公共API，无需注册、认证或API密钥即可使用。所有数据均通过开放数据协议提供，可用于商业和非商业项目。

API的请求频率是否有限制？

API没有严格的速率限制，但建议合理控制请求频率以避免服务器过载。对于大批量数据获取，建议使用分页参数并适当间隔请求。博物馆鼓励负责任的API使用。

API返回的图像数据可以商用吗？

大部分图像遵循公共领域或知识共享协议，但具体使用权限需查看每件艺术品的权利声明。建议在使用前检查'rightsAndReproduction'字段，确认特定图像的使用条款。