Goodreads API

Live-scraped Goodreads data API. Search books, get detailed book info, author profiles, reviews, similar books, quotes, genre pages, and Listopia lists.

原始信息汇总

Goodreads API 数据集概述

基本信息

• 数据集名称: Goodreads API
• 提供平台: RapidAPI
• 提供者: elis-lab
• 数据类别: Media
• API版本: v1 (current)
• 数据获取方式: 实时抓取（Live-scraped）

核心特性

• 端点数量: 10个端点，比最接近的竞争对手多67%。
• 独特端点: 包含5个其他提供商没有的独特端点。
• 请求与速率: 在相同价格下提供比市场领导者多2倍的请求量，速率限制比所有竞争对手高3-10倍。
• 数据新鲜度: 实时抓取，始终为最新数据，非静态数据集。
• 可靠性: 可靠的正常运行时间与快速的响应时间。

端点列表

方法	路径	描述	备注
GET	/search/books	按标题、作者或关键词搜索书籍
GET	/books/{id}	获取完整的书籍详情（评分、流派、ISBN、奖项）
GET	/books/url	通过Goodreads URL获取书籍详情
GET	/books/{id}/reviews	获取社区评论及评论者统计信息	⭐
GET	/books/{id}/similar	获取“读者也喜欢”的推荐书籍	⭐
GET	/books/{id}/quotes	获取特定书籍的引用	⭐
GET	/authors/{id}	获取作者简介及作品列表
GET	/quotes/search	通过关键词搜索引用
GET	/genres/{genre}	获取流派页面：新发布、热门书籍	⭐
GET	/lists/{id}	获取Listopia排名阅读列表	⭐

⭐ 表示该端点为独特端点，其他Goodreads API不提供。

关键端点详情

搜索书籍 (GET /search/books)

• 必需参数: query (字符串，搜索查询)
• 可选参数: page (整数，页码，默认为1)
• 响应: 包含 results[] (含 bookId, title, series, author, avgRating, ratingsCount, coverImage, goodreadsUrl 等字段)，以及 totalResults, currentPage, totalPages。

获取书籍详情 (GET /books/{id})

• 响应字段: id, title, series, authors[], description, coverImage, avgRating, ratingsCount, reviewsCount, pages, format, publicationDate, isbn, genres[], awards[], ratingBreakdown, workId, goodreadsUrl。

获取书籍评论 (GET /books/{id}/reviews)

• 响应: 最多30条评论，包含 reviewId, reviewer (含 id, name, profileUrl), rating, date, body, likesCount, commentsCount。

获取相似书籍 (GET /books/{id}/similar)

• 响应: “读者也喜欢”轮播数据，包含 bookId, title, author, coverImage, goodreadsUrl。

获取书籍引用 (GET /books/{id}/quotes)

• 查询参数: page (页码)
• 响应: 每页30条引用，包含 text, attribution, tags[]，以及 total, hasNextPage。

获取作者简介 (GET /authors/{id})

• 响应字段: id, name, photo, bio, avgRating, ratingsCount, followersCount, genres[], booksCount, books[]。

搜索引用 (GET /quotes/search)

• 查询参数: query (关键词), page (页码)
• 响应: 每页20条引用，包含 text, attribution, tags[]，以及 currentPage, hasNextPage。

获取流派页面 (GET /genres/{genre})

• 流派示例: fantasy, mystery, romance, science-fiction, thriller 等。
• 响应字段: description, newReleases[], mostReadThisWeek[], popularBooks[], relatedGenres[]。

获取Listopia列表 (GET /lists/{id})

• 查询参数: page (页码)
• 热门列表ID示例: 264 (Everyone Should Read), 1 (Best Ever), 6 (Best 21st Century)。
• 响应字段: title, description, booksCount, books[] (含 rank, bookId, title, author, avgRating)。

分页信息

端点	每页数量	参数
/search/books	20	?page=N
/books/{id}/quotes	30	?page=N
/quotes/search	20	?page=N
/lists/{id}	100	?page=N

可通过检查响应中的 hasNextPage: true 来判断是否有更多页面。

错误代码

代码	含义
200	成功
404	未找到
422	验证错误
502	上游错误（可重试）

ID查找方法

• 书籍ID: 来自URL goodreads.com/book/show/42844155
• 作者ID: 来自URL goodreads.com/author/show/1077326
• 列表ID: 来自URL goodreads.com/list/show/264

也可使用 /search/books 端点通过编程方式查找ID。

订阅计划

• BASIC: $0.00 / 月
• PRO: $9.99 / 月
• ULTRA: $29.99 / 月
• MEGA: $79.99 / 月

服务指标

• 流行度: 0
• 服务等级: 100%
• 延迟: 1847ms
• 测试状态: N/A