5 分钟上手 GroundAPI REST API
GroundAPI Team ·
本教程将带你从零开始，在 5 分钟内完成第一次 GroundAPI 调用。
第 1 步：获取 API Key
- 访问 groundapi.net 注册账号
- 进入 Dashboard → API Keys → 创建新 Key
- 保存好你的
sk_live_xxxxx密钥
每个新账户每月免费 500 次调用，无需绑定信用卡。
第 2 步：发起第一个请求
用 curl 查询茅台的实时股价：
curl "https://api.groundapi.net/v1/finance/stock?symbol=600519" \
-H "X-API-Key: sk_live_你的密钥"返回结果：
{
"success": true,
"data": {
"symbol": "600519",
"name": "贵州茅台",
"price": 1520.00,
"change_pct": 1.25
}
}第 3 步：用 Python 调用
import requests
API_KEY = "sk_live_你的密钥"
BASE_URL = "https://api.groundapi.net"
headers = {"X-API-Key": API_KEY}
# 查询天气
resp = requests.get(f"{BASE_URL}/v1/life/weather",
params={"city": "北京"},
headers=headers)
print(resp.json())
# 查询快递
resp = requests.get(f"{BASE_URL}/v1/life/logistics",
params={"number": "SF1234567890", "carrier": "sf"},
headers=headers)
print(resp.json())
# 网络搜索
resp = requests.get(f"{BASE_URL}/v1/info/search",
params={"q": "AI Agent 最新进展", "count": 5},
headers=headers)
print(resp.json())所有接口一览
金融数据
| 接口 | 方法 | 路径 | 主要参数 |
|---|---|---|---|
| 股票数据 | GET | /v1/finance/stock | symbol |
| 选股分析 | GET | /v1/finance/stock/screen | industry, pe_max, sort_by |
| A 股大盘 | GET | /v1/finance/market | date |
| 基金数据 | GET | /v1/finance/fund | code, sort_by |
信息服务
| 接口 | 方法 | 路径 | 主要参数 |
|---|---|---|---|
| 网络搜索 | GET | /v1/info/search | q, engine, count, recency |
| 网页抓取 | GET | /v1/info/scrape | url, format |
| 新闻热点 | GET | /v1/info/news | category, limit, page |
生活服务
| 接口 | 方法 | 路径 | 主要参数 |
|---|---|---|---|
| 天气查询 | GET | /v1/life/weather | city, forecast |
| 快递追踪 | GET | /v1/life/logistics | number, carrier |
| IP 定位 | GET | /v1/life/ip | ip |
错误处理
所有接口返回统一格式。当出现错误时：
{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "API Key 无效"
}
}常见错误码：401（密钥无效）、429（超出限速）、502（上游数据源异常）。
下一步
有问题？发邮件到 support@wisefuturus.com。