观星

API 文档

开放 API 适合后续自动化查询和商业化接入。所有 `/api/v1` 接口需要通过 `X-SEO-API-Key` 请求头传入 API Key,也支持 `api_key` 查询参数。
示例中的 `YOUR_API_KEY` 是占位符,请在后台创建 API Key 后使用真实值。

缓存策略

域名 SEO 查询默认读取永久缓存;传入 `refresh=1` 时重新抓取数据,并覆盖当前缓存。返回字段 `cache_status` 可用于识别本次结果来自缓存或强制刷新。
默认永久缓存refresh=1 强制刷新强刷覆盖当前缓存

错误码与限流

401 API Key 无效422 参数错误429 额度或频率限制60 次/分钟基础限流

域名 SEO 查询

GET /api/v1/seo/query
domainrefresh
curl -H "X-SEO-API-Key: YOUR_API_KEY" "https://seo.labup.net//api/v1/seo/query?domain=baidu.com"

域名历史快照

GET /api/v1/seo/history
domainrangelimit
curl -H "X-SEO-API-Key: YOUR_API_KEY" "https://seo.labup.net//api/v1/seo/history?domain=baidu.com&range=30d&limit=10"

关键词检索

GET /api/v1/seo/keywords
qdomainengineword_countscore_minscore_maxsortlimit
curl -H "X-SEO-API-Key: YOUR_API_KEY" "https://seo.labup.net//api/v1/seo/keywords?q=SEO&sort=opportunity&limit=20"

长尾词分组

GET /api/v1/seo/long-tail
keywordlimit
curl -H "X-SEO-API-Key: YOUR_API_KEY" "https://seo.labup.net//api/v1/seo/long-tail?keyword=SEO查询&limit=50"