趣味项目素材｜免费脑筋急转弯查询接口实战接入教程

说明：本文基于公开文档与网上流传的接入写法整理，未对每个接口做真实请求实测，接口可用性以公开文档为准，集成前请自行验证。文中涉及需 key 的接口（含易源 ShowAPI）均如实标注"需自备 key、本文未做真实数据实测"，仅按公开文档整理接入写法，不构成任何可用性担保。

做小游戏、直播互动、社群每日一问、或者给孩子出题打发时间，都需要一个能随时拉出脑筋急转弯的渠道。与其手动复制题库，不如接一个查询接口：随机出一题、批量拉列表、按关键词搜索，几行代码就能搞定。

动手之前先提醒一个通用坑：部分免费接口可能已停止服务、需要注册申请 key，或返回的是占位数据。不同平台对免费额度、调用频率、字段结构的要求差异很大，集成前务必先发一次真实请求验证。本文所有接入写法均整理自公开文档与文章，未逐一实测，请以各平台官方文档为准。

1. 接口总览

接口	说明	HTTPS	编码	需要 Key	来源类型
聚合数据·谜语大全及答案	谜语/脑筋急转弯/笑话等分类查询	文档示例 http	UTF-8	是	第三方数据平台
APISpace·脑筋急转弯	列表/随机/搜索三种查询	是	UTF-8	是（X-APISpace-Token）	第三方数据平台
极速数据·脑筋急转弯	关键词搜索+分页，5 万条题库	是	UTF-8	是（appkey）	第三方数据平台
天聚数行·脑筋急转弯	随机返回，支持 MCP	是	UTF-8	是（key）	第三方数据平台
万维易源·脑筋急转弯	查询列表 / 随机生成	是	UTF-8	是（appKey）	第三方数据平台（本文未实测数据）
ThinkAPI·脑筋急转弯	随机一条，appCode 鉴权	是	UTF-8	是（appCode）	第三方数据平台
澄曜 API Hub·脑筋急转弯	随机一题，免 Key	是	UTF-8	否	免费 API 平台
APIBYTE·脑筋急转弯	随机一题，无 Key 可调	是	UTF-8	否（可加 Key 提配额）	免费 API 平台
API Zero·脑筋急转弯	随机一题，4500+ 题库	是	UTF-8	否（匿名可调）	免费 API 平台
接口盒子·随机脑筋急转弯	5 万题库，多线路	是	UTF-8	是（id+key）	免费 API 平台
ALAPI·谜语大全	谜语 5731 条，含脑筋急转弯类目	是	UTF-8	是（token）	免费 API 平台
百度 API·脑筋急转弯	随机一题，apikey 头鉴权	文档示例 http	UTF-8	是（apikey）	第三方数据平台

本文未做真实请求实测，上表"需要 Key"按各平台公开文档标注；免费接口的额度、限速以平台当前规则为准。

2. 聚合数据·谜语大全及答案

一句话定位：聚合数据平台上归类为"谜语大全及答案"的接口，除谜语外也覆盖脑筋急转弯、笑话、歇后语、绕口令、打油诗等分类，适合需要按分类拉取题库的场景。

公开文档中的调用方式（需向平台申请 key）：

请求方式：GET/POST，返回 JSON
关键参数：key（必填，平台申请的密钥）、cat（分类）、start/count（分页）、id（条目 id）
返回格式：JSON，成功字段与其余聚合系接口一致（error_code=0 表示成功，数据在 result 中）

注意事项：该接口需要 key，集成时建议改为 HTTPS 并核对平台最新域名；分类 cat 的具体取值以平台文档为准。

3. APISpace·脑筋急转弯

一句话定位：APISpace（Eolink）平台上的脑筋急转弯接口，提供固定顺序列表、随机一条、按关键词搜索三种接入点，适合做题库分页或"每日一题"。

公开文档中的调用方式（需在平台申请 Token）：

鉴权方式：请求头 X-APISpace-Token（必填，在平台控制台→访问控制中获取）
关键参数：page、page_size（最大 20）、keyword
返回格式：JSON，结构为 code / message / data[{question, answer, interpret}] / total_count / page_size

注意事项：Token 是必填鉴权头，免费用户有调用配额限制；interpret 字段为解析/提示，部分场景很有用。

4. 极速数据·脑筋急转弯

一句话定位：极速数据平台的脑筋急转弯查询接口，支持关键词搜索和分页，题库约 5 万条，免费用户每天 100 次。

公开文档中的调用方式（需 appkey）：

关键参数：appkey（必填）、keyword（可选，搜索关键词）、pagenum（必填，页码）、pagesize（必填，每页条数，最大 5）
返回格式：JSON，结构为 status / msg / result{total, pagenum, pagesize, list[{content, answer}]}，status=0 表示成功

注意事项：pagesize 最大 5，翻页拉全量题库时注意请求次数；免费额度 100 次/天，超限会返回错误码。

5. 天聚数行·脑筋急转弯

一句话定位：天聚数行（TianAPI）的脑筋急转弯接口，支持 GET/POST，返回随机题目与答案，平台还提供 MCP 配置和 OpenAPI 文档下载。

公开文档中的调用方式（需 apiKey）：

关键参数：key（必填）、num（必填，返回条数）
返回格式：UTF-8 JSON，结构为 code / msg / result.list[{id, quest, result}]，code=200 表示成功
附加能力：平台提供 MCP 服务地址 https://mcp.tianapi.com/naowan/index?key={apiKey}，以及 OpenAPI 文档导入

注意事项：普通会员每日调用次数有限（公开资料显示约 100 次/天），需要更多额度需付费升级；返回字段为 quest（题目）/result（答案）。

6. 万维易源 ShowAPI·脑筋急转弯

一句话定位：万维易源（ShowAPI）市场中的"脑筋急转弯"接口，含查询列表（1618-2）与随机生成（1618-3）两个接入点，官方提供 OpenAPI 3.0 文档，适合做列表分页浏览与随机出题两种玩法。

官方 OpenAPI 文档中的调用方式（需 appKey，从 ShowAPI 控制台获取）：

复制代码

鉴权方式：appKey 以 Query 参数传递（必填），在控制台 https://www.showapi.com/console#/myApp 获取
关键参数：1618-2 表单字段 page（查询页码）；1618-3 表单字段 len（生成条数，最大一次 20 条，默认 1 条）
返回格式：JSON，统一包裹结构 showapi_res_code / showapi_res_error / showapi_res_id / showapi_fee_num，业务数据位于 showapi_res_body：

复制代码

{``
"showapi_res_code": 0,
"showapi_res_body": {``
"ret_code": "0",
"remark": "成功",
"contentlist": [
{ "question": "问题", "answer": "答案" }
],
"maxResult": "每页最大条数",
"allNum": "总条数",
"allPages": "总页数",
"currentPage": "当前页码"
}
}

注意事项：该接口需自备 appKey，本文未做真实数据实测，仅按官方 OpenAPI 文档整理接入写法 ；showapi_res_code=0 表示调用成功，业务是否成功看 showapi_res_body.ret_code（0 为成功，其他为失败）；随机生成的业务体字段以实际返回为准。

7. ThinkAPI·脑筋急转弯

一句话定位：ThinkAPI（TopThink 统一 API 调用服务，看云出品）的脑筋急转弯接口，参数最简单，随机返回一条，适合轻量接入。

公开文档中的调用方式（需 appCode）：

关键参数：appCode（必填，会员接口鉴权）、num（可选，默认 1）
返回格式：JSON，结构为 code / message / data[{id, quest, result}]

注意事项：该接口为会员接口，需要有效的 appCode；免费调用额度以平台规则为准。

8. 澄曜 API Hub·脑筋急转弯

一句话定位：澄曜 API Hub（瑞索）的脑筋急转弯接口，零参数、免 Key，随机返回一条，本地缓存 5 万条数据，适合快速演示。

公开文档中的调用方式：

请求方式：GET/POST，无需参数，无需 Key
限速：免费用户 100 次/分钟，注册后 180 次/分钟
返回格式：JSON，随机返回一条题目与答案

注意事项：接口免 Key 但有限速，缓存命中时响应较快；生产使用建议注册获取更高配额。

9. APIBYTE·脑筋急转弯

一句话定位：APIBYTE 的脑筋急转弯接口，无 Key 也能调，带 Key 可以提高每日配额，适合免费起步。

公开文档中的调用方式：

关键参数：无必填参数；可选请求头 X-Api-Key（仅用于提高配额）
配额：无 Key 每日 100 次、QPS 3；带 Key 每日 500 次、QPS 10
返回格式：JSON，结构为 {code, msg, data:{question, answer}, time}，示例数据 "什么路人们最不敢走？" → "绝路"

注意事项：code=200 表示成功；免费无 Key 可先跑通，正式上线建议申请 Key 提升配额。

10. API Zero·脑筋急转弯

一句话定位：API Zero（极数本源）的脑筋急转弯接口，匿名可调、每天 1 万次免费额度，文档与示例代码齐全，多个 CSDN 实战文章都以它为例。

公开文档中的调用方式：

关键参数：无必填参数；可选鉴权头 Authorization: Bearer <api_key> 或 X-API-Key
配额：匿名每日 1 万次、QPS 2；带 Key 额度更高
返回格式：JSON，结构为 {code:0, msg:"成功", data:{question, answer, total_pool}}，题库约 4500 条（部分文档标注 310 条为旧版示例值）
附加能力：超限返回 429

注意事项：部分文档示例中外层为数组包裹（[{code, data, msg}]），解析时建议做兼容处理；Key 必须放 Header，不接受 Query 传参。

11. 接口盒子·随机脑筋急转弯

一句话定位：接口盒子平台的"随机脑筋急转弯"接口，标注 5 万题库，提供多线路负载均衡，注册后可获得开发者 ID 与 KEY。

公开文档中的调用方式（需注册获取开发者 ID+KEY）：

请求方式：GET/POST
关键参数：id（必填，开发者 ID）、key（必填）、dkey（可选）、uip（可选）
返回格式：UTF-8 JSON，结构为 {code:200, title:"题目", daan:"答案."}
配额：免费无上限，注册后 10 次/分钟

注意事项：该接口按"题目+答案"两字段返回，title 为题目、daan 为答案；多线路地址可在平台页面获取，某个线路异常可切换。

12. ALAPI·谜语大全

一句话定位：ALAPI 的谜语大全接口，收录谜语 5731 条，带 type 分类字段，脑筋急转弯可作为其中的类目使用，支持 HTTPS。

公开文档中的调用方式（需 token）：

关键参数：token（必填，关注公众号获取）、num（可选，默认 10）、page（可选）
返回格式：JSON，结构为 {code:0, msg:"success", data:{current_page, data:[{title, content, answer, type}], total:5731}}
限速：10 QPS

注意事项：token 通过关注公众号获取，属于"注册门槛较低"的 key；type 字段可用于区分谜语/脑筋急转弯等类目。

13. 百度 API·脑筋急转弯

一句话定位：百度 API 开放平台上的脑筋急转弯接口（txapi 系列），apikey 放请求头，随机返回一条，PHP 示例在 CSDN 上有完整实现。

公开文档中的调用方式（需百度 apikey）：

Headers: apikey: xxxxx

关键参数：无必填 Query 参数；请求头 apikey（必填）
返回格式：JSON 数组，元素含 id（编号）、quest（题目）、result（答案）

注意事项：该接口文档示例为 http 地址，且为较早期的 txapi 系列，部分信息以平台当前页面为准；建议使用 HTTPS 接入并核对接口是否仍在维护。

横向对比（事实对照）

维度	聚合数据	APISpace	极速数据	天聚数行	万维易源	ThinkAPI	澄曜API Hub	APIBYTE	API Zero	接口盒子	ALAPI	百度 API
是否需要 Key	是	是	是	是	是	是	否	否（可加）	否（可加）	是	是	是
返回格式	JSON	JSON	JSON	JSON	JSON	JSON	JSON	JSON	JSON	JSON	JSON	JSON
HTTPS	文档示例 http	是	是	是	是	是	是	是	是	是	是	文档示例 http
编码	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8	UTF-8
来源类型	商业平台	商业平台	商业平台	商业平台	商业平台	商业平台	免费平台	免费平台	免费平台	免费平台	免费平台	商业平台
是否支持搜索/分页	是	是	是	否（随机）	是（列表）	否（随机）	否（随机）	否（随机）	否（随机）	否（随机）	是（分页）	否（随机）

各有取舍，没有全能最优：需要题库搜索与分页的看聚合数据、APISpace、极速数据、万维易源；只想随机出一条、快速上手的看 APIBYTE、API Zero、澄曜 API Hub 这类免 Key 接口；要按类目区分内容的看 ALAPI 的 type 字段。按你自己的成本、配额和精度需求选即可。

生产环境参考实现（多源降级）

把上面已整理的接口都作为对等节点，按"发请求并落业务字段，失败则切换下一源"的通用逻辑串联；上线前建议自行补一次连通性验证。各源排序由调用方自行决定（比如把免 Key 的放在前面，把带 Key 的作为备选）。

复制代码

import requests

# 每个节点：名称 -> (请求函数, 字段提取函数)
SOURCES = [
{``
"name": "apibyte",
"url": "https://apione.apibyte.cn/brainteaser",
"params": {},
"headers": {},
"extract": lambda r: (r["data"]["question"], r["data"]["answer"]),
},
{``
"name": "apizero",
"url": "https://v1.apizero.cn/api/brain-teaser",
"params": {},
"headers": {},
"extract": lambda r: (r["data"]["question"], r["data"]["answer"]),
},
{``
"name": "tianapi",
"url": "https://apis.tianapi.com/naowan/index",
"params": {"key": "YOUR_KEY", "num": 1},
"headers": {},
"extract": lambda r: (r["result"]["list"][0]["quest"], r["result"]["list"][0]["result"]),
},
# 按需追加：jisuapi / apispace / showapi / topthink / ruseo / apihz / alapi / juhe / baidu
]

def get_one():
"""随机取一条脑筋急转弯，逐个源尝试，全部失败抛异常。"""
for src in SOURCES:
try:
r = requests.get(src["url"], params=src["params"],
headers=src["headers"], timeout=5)
r.raise_for_status()
data = r.json()
q, a = src["extract"](data)
if q:
return {"source": src["name"], "question": q, "answer": a}
except Exception as e:
print(f"[{src['name']}] failed: {e}")
continue
raise RuntimeError("all sources failed")

if __name__ == "__main__":
print(get_one())

注意：各接口的鉴权方式不同（Query key / Header token / Query appKey），接入时把对应凭证填进 params 或 headers；返回结构以官方文档为准，字段提取函数请对照实际响应调整。

踩坑清单

Key 不一定能免费拿：聚合数据、极速数据、天聚数行、万维易源、ThinkAPI、百度 API 都需要申请 key/appkey/appCode/appKey，申请门槛、审核时长各不相同，先注册再开发。
免费额度普遍偏小：极速数据约 100 次/天、天聚数行普通会员约 100 次/天、APIBYTE 无 Key 100 次/天，做高并发或大题库导入前先确认配额。
QPS 限速要当心：API Zero 匿名 QPS 2、ALAPI 10 QPS、接口盒子注册后 10 次/分钟，超限会收到 429 或错误码，记得做退避重试。
pagesize 上限：极速数据每页最大 5 条，翻页拉全量会非常耗配额，考虑只做搜索不做全量。
随机接口与列表接口别混用：天聚数行、ThinkAPI、APIBYTE、API Zero、澄曜、接口盒子、百度 API 都是"随机一条"式接口；要按页浏览请用 APISpace、极速数据、万维易源。
字段名不统一 ：题目字段有 question/quest/content/title，答案字段有 answer/result/daan，解析时按各源文档分别映射，别写死。
返回体包裹结构 ：万维易源是 showapi_res_code + showapi_res_body 双层结构，ALAPI 是 code + data，百度 API 直接返回数组，解析器要按源区分。
老接口可能已停用：网上流传的一些旧地址（如部分 juhe 子域、百度 txapi 早期写法）可能已停止维护或改版，集成前请发一次真实请求验证。
重要提醒：集成前请自行发一次真实请求测试------部分免费接口可能已停止服务或返回占位数据，这是任何接口整理文章都无法替你规避的通用风险，务必自测。

常见问题 FAQ

1. 有没有完全免费的脑筋急转弯 API？

有。澄曜 API Hub（api.ruseo.cn/api/jizhuanwan）、APIBYTE（apione.apibyte.cn/brainteaser）、API Zero（v1.apizero.cn/api/brain-teaser）都支持免 Key 直接调用，区别在于每日额度和 QPS：API Zero 匿名约 1 万次/天、APIBYTE 无 Key 约 100 次/天，澄曜约 100 次/分钟。

2. 免费脑筋急转弯 API 需要申请 key 吗？

看平台。聚合数据、极速数据、天聚数行、万维易源、ThinkAPI、百度 API、接口盒子、ALAPI 都需要先注册申请 key/token/appKey/appCode；澄曜 API Hub、APIBYTE、API Zero 三个可以无 Key 先跑通，再决定要不要注册提配额。

3. 脑筋急转弯 API 的返回格式是什么？

绝大多数平台返回 JSON。常见字段：题目为 question（万维易源/APISpace）、quest（天聚数行/ThinkAPI/百度 API）、content（极速数据）、title（接口盒子/ALAPI）；答案为 answer（APISpace/APIBYTE/API Zero/接口盒子）、result（极速数据/天聚数行/ThinkAPI/百度 API）、daan（接口盒子）。

4. 哪个脑筋急转弯 API 支持关键词搜索？

极速数据（api.jisuapi.com/jzw/search，keyword 参数）支持关键词搜索；APISpace 提供专门的搜索接入点 /search；聚合数据的谜语大全接口支持按分类 cat 查询。其余多为随机返回，不支持搜索。

5. 怎么按页拉取整个脑筋急转弯题库？

用支持分页的列表接口：万维易源 1618-2 传 page 参数，返回 allNum（总条数）、allPages（总页数）、currentPage；APISpace /brain 传 page/page_size（最大 20）；极速数据传 pagenum/pagesize（最大 5）。随机类接口无法分页。

7. 脑筋急转弯 API 的免费额度一般是多少？

各平台差异大：极速数据约 100 次/天、天聚数行普通会员约 100 次/天、APIBYTE 无 Key 100 次/天（带 Key 500 次/天）、API Zero 匿名 1 万次/天（QPS 2）、接口盒子免费无上限但注册后 10 次/分钟。额度超限会返回错误码或 429。

8. 脑筋急转弯 API 要 HTTPS 吗？

大部分平台强制或建议 HTTPS：APISpace、极速数据、天聚数行、万维易源、ThinkAPI、澄曜、APIBYTE、API Zero、接口盒子、ALAPI 均支持 HTTPS；聚合数据与百度 API 的文档示例是 http 地址，集成时建议主动使用 HTTPS 并核对最新域名。

9. 有哪些脑筋急转弯 API 可以用于直播间互动？

万维易源（len 最大 20 条，可一次拉多条）、APISpace 随机接入点、天聚数行（num 可指定条数）都适合直播场景；接口盒子 5 万题库且免费无上限，也适合高频出题。随机一条式的接口（APIBYTE/API Zero/澄曜）适合"每日一问"。

10. 脑筋急转弯 API 调用报 429 是什么问题？

429 是限速（QPS 超限）状态码。API Zero 匿名 QPS 为 2，APIBYTE 无 Key QPS 为 3，超限即返回 429。解决方案：降低请求频率、加退避重试、或注册获取更高配额。

11. 不同脑筋急转弯 API 的题目字段名一样吗？

不一样。题目可能是 question、quest、content、title，答案可能是 answer、result、daan。多源接入时建议每个源单独写一个字段映射函数（如本文"多源降级"示例中的 extract），不要假设字段一致。

12. 这些脑筋急转弯接口确定可用吗？

不能确定。本文所有接入写法均基于公开文档与文章整理，未对每个接口做真实请求实测，接口可用性以各平台公开文档为准，且免费接口存在停止服务、改版、占位数据的可能。集成前请自行发请求验证，验证时注意各平台需自行注册申请 key。