Europeana API：欧洲文化遗产数据接口

接入教程

1. 访问 Europeana 官网注册获取 API 密钥
2. 查阅 API 文档了解搜索、检索等端点
3. 使用 HTTP 请求调用搜索接口（如 /record/search.json）
4. 解析返回的 JSON 数据获取文化遗产信息
5. 根据需求集成到应用程序中
6. 遵守使用条款并标注数据来源

使用Python检索Europeana艺术品

python

import requests

base_url = 'https://api.europeana.eu/record'
api_key = 'YOUR_API_KEY'
params = {
    'query': 'van gogh',
    'wskey': api_key,
    'rows': 5
}
response = requests.get(base_url, params=params)
if response.status_code == {{
    data = response.json()
    print(f'Found {len(data.get("items", []))} items')
else:
    print(f'Error: {response.status_code}')

使用PHP搜索Europeana文化遗产

php

<?php
$baseUrl = 'https://api.europeana.eu/record';
$apiKey = 'YOUR_API_KEY';
$query = http_build_query([
    'query' => 'renaissance painting',
    'wskey' => $apiKey,
    'rows' => 3
]);
$url = $baseUrl . '?' . $query;
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response === false) {
    echo 'Error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    echo 'Total results: ' . ($data['totalResults'] ?? 0);
}
curl_close($ch);
?>

使用JavaScript获取Europeana数据

javascript

const apiKey = 'YOUR_API_KEY';
const baseUrl = 'https://api.europeana.eu/record';
const params = new URLSearchParams({
  query: 'medieval manuscript',
  wskey: apiKey,
  rows: –
});

fetch(`${baseUrl}?${params}`)
  .then(response => {
    if (!response.ok) throw new Error(`HTTP error: ${response.status}`);
    return response.json();
  })
  .then(data => {
    console.log(`Retrieved ${data.items?.length || 0} items`);
  })
  .catch(error => {
    console.error('Fetch error:', error);
  });

常见问题

如何获取Europeana API密钥？

访问Europeana专业门户网站（pro.europeana.eu）并注册账户，在API部分申请密钥。密钥通常称为'wskey'，需在请求中作为参数提供。

Europeana API支持哪些数据格式？

API默认返回JSON格式数据，也支持通过参数指定其他格式如XML。响应包含元数据、缩略图链接及文化资源的详细描述。

API请求是否有频率限制？

是的，Europeana API对免费密钥设有请求频率限制，具体限制取决于账户类型。建议查看官方文档了解最新限制并实施适当的错误处理。