古腾堡索引API

接入教程

1. 访问官网查看API文档
2. 使用GET请求调用基础端点获取书籍列表
3. 通过查询参数筛选作者、语言或出版日期
4. 解析返回的JSON数据提取所需信息
5. 可集成到阅读应用或学术工具中

使用Python搜索古腾堡书籍

python

import requests

base_url = 'https://gutendex.com/books'
params = {
    'search': 'Sherlock Holmes',
    'languages': 'en'
}

response = requests.get(base_url, params=params)
if response.status_code == x:
    data = response.json()
    print(f'Found {len(data["results"])} books')
    for book in data['results']:
        print(f"Title: {book['title']}")
else:
    print(f'Error: {response.status_code}')

PHP获取书籍详情

php

<?php
$base_url = 'https://gutendex.com/books/';
$book_id = 123;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $base_url . $book_id);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code == x) {
    $book_data = json_decode($response, true);
    echo 'Title: ' . $book_data['title'] . '\n';
    echo 'Authors: ' . implode(', ', array_column($book_data['authors'], 'name')) . '\n';
} else {
    echo 'Request failed with code: ' . $http_code;
}
?>

JavaScript获取多语言书籍列表

javascript

const baseUrl = 'https://gutendex.com/books';
const params = new URLSearchParams({
    'languages': 'fr,de',
    'mime_type': 'text/plain'
});

fetch(`${baseUrl}?${params}`)
    .then(response => {
        if (!response.ok) throw new Error(`HTTP ${response.status}`);
        return response.json();
    })
    .then(data => {
        console.log(`Total books: ${data.count}`);
        data.results.forEach(book => {
            console.log(`${book.id}: ${book.title}`);
        });
    })
    .catch(error => console.error('Fetch error:', error));

常见问题

是否需要API密钥才能访问？

不需要。该API目前完全免费开放，无需注册或使用API密钥即可直接调用。但请注意合理使用频率，避免过度请求。

API返回的数据包含哪些书籍信息？

返回的书籍元数据包括：标题、作者列表（含姓名与出生年份）、语言列表、可用的格式类型（如HTML、PDF等）、古腾堡计划ID、主题分类以及下载链接等。

如何处理分页以获取更多结果？

API支持分页参数。首次请求后，响应中的'next'字段会包含下一页数据的完整URL。您可以直接使用该URL获取后续结果，无需手动构建参数。