天聚数行（TianAPI）API 接口对接
国内综合性 API 接口平台，提供 234 个接口，涵盖新闻、天气、生活工具、AI 智能等。
使用前提
- 注册 tianapi.com 账号
- 控制台获取 API Key（已配置于
call_tianapi函数中） - 免费接口需先点击"申请接口"
API 信息
| 项目 | 值 |
|---|---|
| 基础域名 | https://apis.juhe.cn/fapigx/{api_name}/query |
| 请求方式 | GET/POST |
| 返回格式 | UTF-8 JSON |
| 认证方式 | URL 参数 key={apiKey} |
通用调用方式
import requests
TIANAPI_KEY = "b32728bac74d956d8e33015188a2c5a2"
def call_tianapi(api_name: str, params: dict = None) -> dict:
"""调用天行数据 API 的通用函数"""
url = f"https://apis.juhe.cn/fapigx/{api_name}/query"
if params is None:
params = {}
params["key"] = TIANAPI_KEY
params["dtype"] = "json"
response = requests.get(url, params=params, timeout=10)
return response.json()
返回结构
{
"code": 200, // 200=成功，其他为错误码
"msg": "success",
"result": { ... }
}
已申请免费接口（快捷调用）
> 以下接口每日 100 次免费额度，调用时注意 1 次/秒 频率限制。
| 接口 | 路径名 | 调用方式 | 说明 |
|---|---|---|---|
| 国内新闻 | guonei |
call_tianapi("guonei", {"num": 10}) |
国内时政、经济、社会热点 |
| 社会新闻 | social |
call_tianapi("social", {"num": 10}) |
社会热点、公共事件 |
| 微信文章精选 | wxnew |
call_tianapi("wxnew", {"num": 10}) |
公众号优质文章（已停更，仅查旧数据） |
| AI资讯 | ai |
call_tianapi("ai", {"num": 10}) |
人工智能、大模型、算法前沿 |
| 每日简报 | bulletin |
call_tianapi("bulletin") |
每日新闻简报汇总 |
| 全网热搜榜 | networkhot |
call_tianapi("networkhot", {"num": 10}) |
聚合微博/抖音/百度/知乎热搜 |
使用示例
1. 查询天气
result = call_tianapi("tianqi", {"city": "101020100", "type": "1"})
2. 查询热搜榜
result = call_tianapi("networkhot", {"num": "10"})
3. 智能翻译
result = call_tianapi("translate", {"text": "Hello World", "to": "zh"})
4. IP 归属地查询
result = call_tianapi("ipquery", {"ip": "8.8.8.8"})
5. 天行机器人对话
result = call_tianapi("robot", {"question": "今天天气怎么样", "userid": "user001"})
接口分类索引
按以下分类组织（详细接口列表可访问官网 API 文档 查看）：
| 分类 | 包含接口示例 |
|---|---|
| 新闻资讯 | 国内新闻、国际新闻、社会新闻、AI资讯、科技新闻等 28 个 |
| 热搜榜单 | 全网热搜榜、百度热搜、抖音热搜、腾讯热搜等 5 个 |
| 生活服务 | 天气预报、空气质量、手机归属地、IP查询、老黄历等 15 个 |
| 翻译语言 | 机器翻译、简繁转换、汉字转拼音、词典等 10 个 |
| 知识问答 | 天行机器人、百科题库、脑筋急转弯等 10 个 |
| 诗词文学 | 唐诗、宋词、诗经、成语典故等 15 个 |
| 趣味娱乐 | 土味情话、彩虹屁、朋友圈文案、段子等 24 个 |
| 运势命理 | 星座运势、星座配对、周公解梦等 6 个 |
| 功能应用 | 二维码、网页抓取、藏头诗、单位换算等 18 个 |
| 数据智能 | 关键词提取、文本分类、图像识别、人脸识别等 25 个 |
| 企业商务 | 工商查询、发票查验、WHOIS查询、PDF提取等 12 个 |
| 其他常用 | 菜谱查询、药品说明书、历史上的今天等 25 个 |
MCP 协议接入
天行数据已适配 MCP（Model Context Protocol），可在 Cherry Studio、GitHub Copilot 等 AI 客户端中直接使用。
{
"mcpServers": {
"tianapi-xxx": {
"url": "https://mcp.tianapi.com/xxx/index?key={apiKey}"
}
}
}
错误码速查
| 错误码 | 含义 | 处理建议 |
|---|---|---|
| 200 | 成功 | 正常处理数据 |
| 130 | 调用频率超限 | 降低请求频率（默认 1 次/秒） |
| 140 | 接口或密钥无权限 | 检查控制台是否停用 |
| 150 | 可用次数不足 | 购买天豆资源包 |
| 160 | 未申请该 API | 先在文档页申请接口 |
| 190 | API 密钥不可用 | 账号无效或 Key 被禁 |
| 230 | API 密钥无效 | 检查 Key 是否正确 |
完整错误码列表可访问官网 错误码说明 查看。
注意事项
- 频率限制：默认 1 次/秒，超出返回错误码 130
- 编码格式：全站 UTF-8，中文参数建议 urlencode 编码
- 免费接口：标注 * 的接口会员免费，申请即送 1000 次
- 计费接口：使用天豆（1 天豆 ≈ 0.02 元），10 元 = 50000 次
- 数据缓存：部分新闻类接口有缓存延迟（10-30 分钟）
- MCP 安全：MCP 为代理模式调用，请严格保管密钥
- 控制台：https://www.tianapi.com/console/ 管理接口和查看调用统计
相关链接
- 官网：https://www.tianapi.com/
- 控制台：https://www.tianapi.com/console/
- 接口文档：https://www.tianapi.com/openapilist.html
- MCP 服务：https://www.tianapi.com/mcp/
