Anime Quotes API

Access thousands of memorable quotes from popular anime series. Filter by character, title, or get a random quote — perfect for bots, apps, and fan projects.

原始信息汇总

数据集概述：Anime Quotes API

Anime Quotes API 是一个提供热门动漫系列台词的 REST API，拥有 8.1 的流行度、100% 的服务水平、255ms 的延迟和 100% 的测试覆盖率，API 创建者为 JohnMikko27，所属分类为娱乐。

核心功能

通过三个主要端点，用户可以按角色名称或动漫标题检索台词，或获取随机台词。

端点详情

所有端点前缀为 /api/v1。

方法	端点	描述
GET	/api/v1/random	返回一条或多条随机动漫台词
GET	/api/v1/character/{character}	根据指定角色名称返回分页的台词列表
GET	/api/v1/title/{title}	根据指定动漫标题返回分页的台词列表

注意： 角色和标题的查找区分大小写（包含空格），且必须完全匹配。

查询参数

端点	参数	类型	默认值	最大值	描述
/random	limit	integer	1	100	返回的随机台词数量
/character/{character}	limit	integer	10	100	每页返回的台词数量
/character/{character}	cursor	integer	1	—	开始分页的ID（参见分页）
/title/{title}	limit	integer	10	100	每页返回的台词数量
/title/{title}	cursor	integer	1	—	开始分页的ID（参见分页）

分页

/character/{character} 和 /title/{title} 端点使用基于游标的分页。cursor 查询参数是下一页第一条台词的ID，而非偏移量或页码。

• 首次请求无需 cursor 参数（默认为开头）。
• 响应中包含 next_cursor 和 next 字段。
• 如果 next_cursor 非空，表示还有更多结果，将其作为 cursor 参数传入后续请求。
• 当 next_cursor 为空字符串 "" 时，表示已到达最后一页。

响应模式

/random 响应：

字段	类型	描述
data	AnimeQuote[]	台词对象数组

/character/{character} 和 /title/{title} 响应：

字段	类型	描述
data	AnimeQuote[]	当前页的台词对象数组
next_cursor	string	获取下一页的游标ID，无更多页时为 ""
next	string	直接可用的下一页请求预构建URL，无更多页时为 ""

AnimeQuote 对象：

字段	类型	描述
id	string	台词的唯一标识符
title	string	台词所属的动漫系列
character	string	说出台词的角色
quote	string	台词文本

错误处理

所有错误均以一致的 JSON 结构返回。

错误响应模式：

json { "error": "not_found", "message": "No rows found. Anime quote with that title doesnt exist.", "status": 404 }

错误码：

状态码	错误代码	描述
400	bad_request	请求格式错误（例如ID不是整数）
401	unauthorized	缺少或无效的API密钥
404	not_found	未找到给定ID、角色或标题的台词
429	too_many_requests	超出速率限制，需在 Retry-After 响应头指定的时长后重试
500	internal_server_error	意外的服务器端错误