Book Data API: ISBN Lookup and Search

Look up any book by ISBN-10/13 or search Open Library’s catalog: title, authors, publishers, subjects, description and cover art. Public domain metadata.

原始信息汇总

Book Data API: ISBN Lookup and Search 数据集详情

一、基本信息

• API名称：Book Data API: ISBN Lookup and Search
• API创建者：AUtomator labs
• 所属分类：Education（教育）
• 订阅者数量：1
• 提供方：RapidAPI 平台

二、官方概述

API Overview 中的描述如下：

Book Data API: ISBN Lookup and Search API Overview

Overview

A live proxy of Open Library (the Internet Archives open book catalog): resolve a book by ISBN-10 or ISBN-13 to full edition metadata (title, authors, publishers, publish date, page count, languages, subjects, description) plus cover art URLs, or free-text search the catalog by title/author.

三、核心功能与用途

• 定位：作为 Open Library（互联网档案馆的书目目录）的实时代理
• 主要功能：通过ISBN-10或ISBN-13查找书籍完整版本元数据
• 适用场景（Built for）：书店/目录增强、图书馆系统、阅读应用程序、价格比较和库存管理工具（仅依据ISBN或条形码进行操作）

四、数据接口与参数说明

API 提供三个主要端点，全部仅支持 GET 请求：

端点	说明
GET /books/isbn/{isbn}	获取单一ISBN（ISBN-10或ISBN-13）对应的完整版本数据（包含最多3位作者信息）
GET /books/search?q=&limit=&page=	按标题/作者进行分页搜索（limit 取值范围1-50，默认值10）
GET /books/isbn/{isbn}/cover	返回小/中/大三种尺寸封面图像URL，无需上游调用

五、示例数据

ISBN 查询示例

GET /books/isbn/9780140328721

返回字段包括：

• 标识字段：isbn_10、isbn_13、openlibrary_key
• 内容字段：title、subtitle、authors、publishers、publish_date、number_of_pages、languages、subjects、description
• 封面字段：cover（含small、medium、large三种URL）

搜索示例

GET /books/search?q=Fantastic+Mr+Fox

返回结构包含 query、total、page、limit 及 results（每项含 title、authors、first_publish_year、isbn、cover、language、publishers、pages、subjects、openlibrary_key 等）。

六、功能边界与局限性

（官方标注为 Honest scope）

• 缓存策略：本API是Open Library的实时代理并带有边缘缓存（ISBN查询TTL为24小时，搜索TTL为6小时）
• 服务依赖：对Open Library自身的可用性不提供SLA（服务等级协议）
• 数据完整度：目录完整度（作者姓名、描述、主题）受限于Open Library已编目情况
• 作者限制：每个版本最多解析3位作者

七、数据来源与许可

• 数据来源：Open Library（openlibrary.org），互联网档案馆（Internet Archive）项目
• 许可协议：Open Library的书目元数据属于公共领域 / CC0（知识共享零版权声明）
• 封面图片：来自 covers.openlibrary.org，遵循Open Library自身条款

八、错误码与响应

错误码	HTTP状态码	含义
INVALID_ISBN	400	ISBN必须是10位数字（末位可为X）或13位数字
INVALID_QUERY	400	搜索q参数必须为2-200个字符
NOT_FOUND	404	该ISBN无对应版本信息
UPSTREAM_UNAVAILABLE	503	上游超时、出错或返回无效JSON
UPSTREAM_RATE_LIMITED	429	上游请求被限流
METHOD_NOT_ALLOWED	405	仅支持GET请求
QUERY_TOO_LONG	414	查询字符串超过512字符

错误响应格式统一为 JSON：{ "error": "<code>", "message": "<text>" }，并带有 Cache-Control: no-store 响应头。

九、价格方案

方案	月费
BASIC	免费
PRO	$12.00
ULTRA	$39.00
MEGA	$99.00