快速开始 接入方式 接口文档 计费限额 错误码 FAQ

快速开始

1

申请 API Key

会员中心创建,明文仅显示一次。

前往创建 →
2

把本页网址发给你的 AI

复制下方网址连同 Key 发给 AI 助手(Claude、Codex 等),它会自行读取本页完成接入与调用。

接入方式

{ "mcpServers": { "gotohui": { "type": "http", "url": "https://www.gotohui.com/api/open/v1/mcp", "headers": { "Authorization": "Bearer 你的Key" } } } }

下载技能文件,放入 AI 工具的 skills/gotohui-data/SKILL.md 技能目录,并设置环境变量 GOTOHUI_API_KEY

下载 SKILL.md

Base URL:https://www.gotohui.com/api/open/v1,所有请求携带请求头 Authorization: Bearer 你的Key。具体接口、参数与返回见下方【接口文档】。

curl "https://www.gotohui.com/api/open/v1/search?word=北京GDP" -H "Authorization: Bearer ghk_xxx"

接口文档

共 8 个接口,响应统一 { status, msg, data },HTTP 状态码恒为 200,以 body 的 status 为准。点击展开查看参数与示例。

GET/data/{id}积分

获取指标完整数值序列(从新到旧)。

参数说明
confirm授权确认(1/true)。未购数据不带 confirm 时只返回报价、不扣分;用户同意后带 confirm=1 重新调用才购买取数

① 第一步(报价,不扣分)——未购买的数据返回 need_authorization,须先向用户说明成本并征得同意:

curl "https://www.gotohui.com/api/open/v1/data/88421" -H "Authorization: Bearer ghk_xxx" { "status": 200, "data": { "need_authorization": true, "code": 503009, "id": 88421, "name": "北京地区生产总值", "unit": "亿元", "points_cost": 1, "points_balance": 499, "charged": false, "message": "获取「北京地区生产总值」需消耗 1 积分买断限期访问权限,当前余额 499。确认后请带 confirm=true 重新调用。" } }

② 第二步(确认购买,返回数值)——带 confirm=1(已购数据可直接拿数值、无需此步):

curl "https://www.gotohui.com/api/open/v1/data/88421?confirm=1" -H "Authorization: Bearer ghk_xxx" { "status": 200, "data": { "id": 88421, "name": "北京地区生产总值", "unit": "亿元", "values": [ { "period": "2025", "value": "49843.10", "calc_value": "5.20" } ], "points_cost": 1, "charged": true, "points_balance": 498 } }

values[] 从新到旧,calc_value 为同比增速(%);确认后自动买断该数据限期访问权限(与站内购买同一权限,网站详情页同步解锁);charged=false 表示本次未扣分(已拥有权限 / 已在站内购买,此时第一步即直接返回数值);价格为 0 的数据无报价步骤。

GET/ranking/list免费

公开榜单列表,取榜前先用它拿到 slug

参数说明
word可选,关键词匹配榜单标题,如「GDP」「人口」
category_id可选过滤,ID 见 /meta/categories
page / limit分页,limit 上限 50

免费/付费榜均返回(is_paid 仅为标记,取榜全部免费)。返回 data.list[]{ slug, title, unit, region_level, is_paid }。记住 slug,取榜用。

GET/ranking/{slug}免费
curl "https://www.gotohui.com/api/open/v1/ranking/gdp/city/330000" -H "Authorization: Bearer ghk_xxx" { "status": 200, "data": { "slug": "gdp/city/330000", "title": "浙江省各地级市GDP总量排行榜", "unit": "亿元", "is_paid": true, "year": 2025, "total": 11, "list": [ { "rank": 1, "region_id": 110, "region_name": "杭州", "value": "23011.00", "unit": "亿元", "trend": 5.27 } ] } }
GET/house-price免费

查询城市/区县二手房、新房均价与租售比。

参数说明
region必填,区域名称(如「深圳」「杭州余杭」),或直接传 region_id 数字
year / month可选,须成对提供;缺省取该区域最新有数据的月份;时间不能超过当前月份
curl "https://www.gotohui.com/api/open/v1/house-price?region=深圳" -H "Authorization: Bearer ghk_xxx" { "status": 200, "data": { "region_id": 49, "region_name": "深圳", "year": 2026, "month": 3, "period": "2026-03", "has_data": true, "unit": "元/㎡", "second_hand_price": 60949.00, "second_hand_total_price": 609.49, "second_hand_price_yoy": -5.20, "second_hand_price_mom": -0.80, "new_house_price": 52900.00, "new_house_total_price": 529.00, "new_house_price_yoy": -3.10, "new_house_price_mom": -0.50, "rent_monthly": 75.00, "rent_yield": 1.38, "data_source": "国家统计局", "latest_period": "2026-03" } }

区域名称匹配到多个时返回候选(不返价):{ ambiguous:true, message, candidates:[{region_id, region_name, parent_region, region_level}] },再用 region_id 指定其一。该月无数据 / 时间超当前月 / 时间参数非法时返回 { has_data:false, message, latest_period },按 latest_period 改取可用月份。免费,但走独立限流档(与其它接口分开计数,见「计费与限额」)。

GET/community/{id}免费

获取社区分析文章的标题与正文(纯文本),ID 来自 channel=community 的搜索结果。返回 { id, title, summary, content, tags, publish_time, ... }。免费,仅受限流约束。

GET/me免费

批量取数前先自检余额与额度。返回 { points_balance, data_points_cost, access_validity_days, daily_limit, daily_used, qps_limit, house_price_daily_limit, house_price_daily_used, house_price_qps_limit }data_points_cost 为取数单价(买断限期)、access_validity_days 为权限有效期天数;house_price_* 为房价接口独立限流档的额度与已用。

GET/meta/categories免费

分类字典,返回顶级数据分类列表({ categories: [{id, name}] }),供 /searchcategory_id 过滤使用。

计费与限额

项目规则
搜索 / 房价 / 社区文章 / 自检 / 字典免费,不消耗积分
取数授权后购买:未购数据先返回报价(need_authorization)不扣分,确认后消耗 1 积分买断该数据限期不限次访问权限(与站内购买同一权限,全站通用);已购数据重复获取有效期内免费
取榜单免费:付费榜/免费榜均全量返回,仅最新年份(与网站榜单页默认年份公开口径一致)
调用频率每个 Key 5 次/秒(房价接口独立 1 次/秒)
每日调用每个 Key 500 次/天(房价以外接口合计);房价接口独立 10 次/天
Key 数量每账户最多 5 个
积分消耗记录在「会员中心 → 积分明细」;已获取数据在「会员中心 → 我的数据」。Key 如怀疑泄露,请立即在会员中心禁用或删除。

错误码

响应统一为 { status, msg, data }(HTTP 状态码恒为 200,以 body 的 status 为准:200 成功 / 400 失败 / 401 鉴权失败)。业务错误附带 code 字段:

code含义建议处理
503001API Key 无效或已禁用检查 Key 是否正确、是否被禁用
503002积分不足前往会员中心充值
503003调用频率超限等待 1 秒后重试
503004今日调用次数已达上限明日再试
503005数据不存在或不可访问确认 ID 来自搜索结果
503006搜索关键词至少需要2个字补全关键词
503007服务暂时不可用稍后重试
503009需授权后购买(报价信号,非错误)出现在取数的报价响应里:向用户说明积分成本,同意后带 confirm=1 重新调用

常见问题

Key 忘了或怀疑泄露怎么办?

明文仅在创建时显示一次,无法找回。怀疑泄露时到会员中心禁用或删除该 Key,再新建一个即可,旧 Key 立即失效。

取数为什么第一次不返回数据?

取数走「授权后购买」:未购买的数据首次调用只返回报价(need_authorization)不扣分,你须先告知用户成本,用户同意后带 confirm=1 重新调用才真正扣分取数。已购数据直接返回、无需确认。

搜索 / 房价 / 社区文章要消耗积分吗?

不消耗。搜索、排行榜、房价、社区文章、账户自检、分类字典均免费,仅受调用频率与每日次数的限流约束。只有取数才扣积分。

一次能搜多个指标吗?

可以。/searchwords(数组或逗号/中文逗号分隔),按词分组返回 groups[],每词各自取上限、互不挤占,省调用次数。

积分消耗和已购数据在哪里查?

积分消耗记录在「会员中心 → 积分明细」;已获取的数据在「会员中心 → 我的数据」,买断限期内可反复获取不再扣分。

福州标点文化传播有限公司|邮箱:admin@gotohui.com

Copyright 2024 gotohui.com闽ICP备08105781号-11闽公网安备35011102350481号

微信小程序

微信服务号