免费 星座运势查询接口推荐：含无需 Key 可直接调用方案

星座运势是社交、内容类应用里高频的趣味模块。很多开发者想要「开箱即用、最好不注册」的接口，但社区里流传的链接大多年久失效或需要密钥。本文先列出当前仍可正常返回数据的免费接口，并点名已失效的方案，帮助你少走弯路。文中所有「可用」结论均基于 2026-08-11 的真实请求。

一、免费接口清单

下面这些接口在实测中均能返回结构化的星座运势数据（HTTP 2xx + 有效 JSON）：

• 万维易源 星座运势查询（872）：官方自营免费服务，中文、字段最全（日 / 明日 / 周 / 月 / 年 + 星座配对），需注册免费 appKey。

• freehoroscopeapi.com：支持日 / 周 / 月运势，无需 Key，免费直接调用，返回英文文案。

• celesian.com：每日运势短句，无需 Key，开启 CORS 便于前端直连，返回英文文案。

• 聚合数据 星座运势：老牌数据平台，有免费额度，需注册获取 Key 后调用，返回中文文案。

⚠️已失效 / 未纳入说明：社区文章中常提到的aztro（aztro.sameerkumar.website）与horoscope-free-api.herokuapp.com均托管在 Heroku 上，随着 Heroku 免费服务下线，实测已返回「No such app」或连接失败，不再可用。云策API（api.auth.top/api/sign）虽自称免费但需密钥，且社区反馈其稳定性与可用性尚不明确，本文暂不纳入推荐清单。

二、免费接口推荐

1、万维易源 星座运势查询（官方，接口 ID 872）

万维易源官方自营的免费服务，数据为中文，字段覆盖最完整：综合 / 爱情 / 事业 / 财富 / 健康指数（5 分制）、幸运色、幸运数字、吉时、贵人星座，以及本日、明日、本周、本月、本年多维运势。另含「星座配对」接入点（872-2）。官方每日 1 点、7 点、17 点更新。

• 接口地址：https://route.showapi.com/872-1?appKey={your_appKey}（GET / POST，返回 JSON）

• 主要参数：star（baiyang/jinniu/…/shuangyu 共 12 个值）、date（MMdd，无 star 时按日期推算）、needTomorrow/needWeek/needMonth/needYear（0/1 控制是否返回对应周期）。

• 适用场景：面向中文用户、需要详尽中文文案与多周期运势、且希望数据源稳定可控的产品。

2、freehoroscopeapi.com

一个开放、无需鉴权的 Horoscope REST API，支持 daily / weekly / monthly 三种周期，返回标准 JSON。适合做原型、英文站点或需要快速接入的场景。

• 接口地址：GET https://freehoroscopeapi.com/api/v1/get-horoscope/{daily|weekly|monthly}?sign=<星座英文名>

• sign 取值（小写）：aries、taurus、gemini、cancer、leo、virgo、libra、scorpio、sagittarius、capricorn、aquarius、pisces。

• 返回示例：{"data":{"date":"2026-08-11","period":"daily","sign":"Aquarius","horoscope":"..."}}

• 注意：文案为英文；调用请控制频率、避免高频刷接口。

3、celesian.com

提供免费可嵌入的占星小组件，运势接口开启 CORS，前端可直接 fetch 调用，无需后端代理。文案为英文短句，适合做轻量展示。

• 接口地址：GET https://celesian.com/api/widget/horoscope?sign=<星座英文名>

• sign 取值（首字母大写）：Aries、Taurus、Gemini、Cancer、Leo、Virgo、Libra、Scorpio、Sagittarius、Capricorn、Aquarius、Pisces。

• 返回示例：{"sign":"Aries","date":"2026-08-11","horoscope":"...","source":"celesian.com"}

• 注意：官方要求使用时保留来源署名（link back to celesian.com）；另有月亮相位等小组件可一并取用。

4、聚合数据 星座运势

聚合数据是老牌数据平台，星座运势接口有免费调用额度，注册并创建应用后获得 APPKEY 即可使用，返回中文文案，文档与在线调试较完善。

• 接口地址：GET http://web.juhe.cn:8080/constellation/getAll?consName=<星座名>&type=<today|tomorrow|week|nextweek|month|year>&key=<APPKEY>

• 返回字段：error_code、reason，以及 name / all / color / health / love / money / number / QFriend / summary / work 等运势项。

• 注意：基础版免费但调用次数有限，高级数据通常收费；无 Key 请求会返回KEY ERROR。

三、参数速览表

四、场景化选型建议

• 面向中文用户、需要详尽中文文案与「星座配对」能力，可考虑万维易源 872（注册免费 appKey 即可长期稳定使用）。

• 做英文产品、快速原型或不想处理密钥与注册，可考虑freehoroscopeapi.com 或 celesian.com，二者均无需 Key。

• 前端直接展示、不想写后端代理，可考虑celesian.com（已开启 CORS，浏览器可直连）。

• 已有聚合数据账号、需要中文且接受免费额度限制，可考虑聚合数据星座运势接口。

• 对调用量有更高要求或需要商用稳定性，建议在上述免费方案之外评估对应平台的商业套餐。

五、实战代码示例

1）freehoroscopeapi.com（Python）

import requests

r = requests.get(
"https://freehoroscopeapi.com/api/v1/get-horoscope/daily",
params={"sign": "aquarius"}
)
data = r.json()["data"]
print(data["date"], data["sign"])
print(data["horoscope"])

2）celesian.com（curl）

curl "https://celesian.com/api/widget/horoscope?sign=Aries"

3）万维易源 星座运势查询（Python，需 appKey）

import requests

params = {
"star": "shizi", # 狮子座
"needTomorrow": 0,
"needWeek": 1,
"needMonth": 0,
"needYear": 0,
}
r = requests.get(
"https://route.showapi.com/872-1",
params={"appKey": "YOUR_APPKEY"},
data=params,
)
body = r.json()["showapi_res_body"]
print(body["day"]) # 本日运势
print(body["week"]) # 本周运势

六、FAQ

Q：这些「免费」接口真的不用花钱吗？

A：万维易源 872、聚合数据属于「注册免费 + 免费额度」模式，超出额度或高级数据可能收费；freehoroscopeapi.com 与 celesian.com 无需 Key、可直接调用，但请遵守其使用说明（如 celesian 要求署名）并控制请求频率。

Q：为什么 aztro 这类老接口打不开了？

A：aztro 与多个开源 Horoscope API 托管在 Heroku，Heroku 已于 2022 年 11 月取消免费 dyno，相关服务随之失效。本文已将其从推荐清单中剔除。

Q：中文运势用哪个最省事？

A：面向中文场景，万维易源 872 提供字段最完整的官方中文数据；若已使用聚合数据生态，也可直接用其星座运势接口（需 Key）。

Q：没有 Key 又想要中文文案怎么办？

A：免费无 Key 的公开接口多为英文文案。若必须中文且无 Key，可行思路是自行部署开源 Horoscope 项目（如 GitHub 上的 Horoscope-API 类仓库）做后端，但这需要一定的运维成本。

实测声明：本文可用性结论基于 2026-08-11 的真实 HTTP 请求得出，免费接口的服务策略可能随时调整，正式接入前建议再次自测。

获取万维易源 appKey：登录万维易源控制台（https://www.showapi.com/console#/myApp）创建应用即可获得免费 appKey；接口详情见 星座运势查询（872）。