114导航
查询网站

开放接口

API 文档

GET/api/site/{domain}

相似网站查询

返回目标站点的标题、描述、分类、全球排名与相似网站列表。

参数
domain（路径参数）：待查询的域名，如 baidu.com
限流
每 IP 30 次/分钟
示例
GET /api/site/baidu.com
{
  "Title": "百度一下，你就知道",
  "Category": "新闻",
  "SimilarSites": [...]
}
GET/api/site-profile/{domain}

站点档案探测

返回域名 RDAP 注册信息与 SSL 证书信息（注册商、到期时间、证书有效期等）。

参数
domain（路径参数）：待探测的域名
限流
每 IP 30 次/分钟
示例
GET /api/site-profile/github.com
{
  "registrar": "MarkMonitor Inc.",
  "ssl": { "issuer": "...", "validTo": "..." }
}
GET/api/favicon?domain={domain}

网站图标代理

多源回退获取网站 favicon，适合在列表页直接作为 <img> 源使用。

参数
domain（查询参数）：目标域名
限流
每 IP 120 次/分钟
示例
GET /api/favicon?domain=github.com
→ image/png（24h 缓存）
POST/api/submit-site

提交收录

提交新域名进入抓取队列，审核处理后收录进索引。

参数
请求体 JSON：{"domain": "example.com"}
限流
每 IP 10 次/分钟
示例
POST /api/submit-site
{"domain": "example.com"}
→ {"ok": true}
GET/api/ai-crawl?domain={domain}

AI 爬虫收录检测

解析目标站 robots.txt，返回 12 家主流 AI 引擎（GPTBot/ClaudeBot/PerplexityBot/Bytespider 等）的允许/阻止状态。

参数
domain（查询参数）：目标域名
限流
每 IP 20 次/分钟
示例
GET /api/ai-crawl?domain=baidu.com
{
  "robotsUrl": "https://baidu.com/robots.txt",
  "engines": [{ "name": "GPTBot", "status": "blocked" }, ...]
}
GET/api/ai-traffic-stats

AI 抓取流量统计

AI 爬虫访问监测仪表盘的机器可读数据（累计/当日抓取量、引擎分布、7 天趋势、热门路径、最近记录），供 AI 引擎与研究者结构化引用；不输出 IP 字段。

参数
无参数
限流
每 IP 60 次/分钟
示例
GET /api/ai-traffic-stats
{
  "total": 1284,
  "today": 37,
  "engineCounts": { "GPTBot": 412, ... },
  "dayTrend": [...],
  "topPaths": [...]
}
GET/api/site-status?domain={domain}

收录状态查询

返回域名在 114导航 的收录状态（indexed 已收录 / queued 排队中 / failed 抓取失败 / unknown 未知）。

参数
domain（查询参数）：目标域名
限流
每 IP 60 次/分钟
示例
GET /api/site-status?domain=baidu.com
{
  "status": "indexed",
  "globalRank": 4
}
GET/api/suggest?q={keyword}

搜索建议

按关键词返回站内已收录站点的搜索建议（域名/标题），用于搜索框即时联想。

参数
q（查询参数）：搜索关键词
限流
每 IP 120 次/分钟
示例
GET /api/suggest?q=bai
{ "suggestions": [{ "domain": "baidu.com", "title": "百度一下，你就知道" }, ...] }
POST/api/ai-find

AI 找站（流式）

输入一句自然语言找站需求，服务端站内检索 + AI 从已收录档案中挑选不超过 3 个站点并流式输出推荐理由（SSE text/event-stream）。只推荐站内已收录站点，检索为空时诚实返回。

参数
请求体 JSON：{"q": "推荐几个免费在线修图工具"}
限流
每 IP 20 次/分钟
示例
POST /api/ai-find
{"q": "推荐几个免费在线修图工具"}
data: {"t":"推荐理由片段..."}
data: {"done":true,"sites":[{"domain":"gimp.org","title":"GIMP"}]}
POST/api/feedback

相似度反馈

相似站推荐质量的众包反馈（👍/👎），按 域名对+IP 哈希 幂等入库，用于相似度引擎调优。

参数
请求体 JSON：{"domain": "google.com", "similarDomain": "youtube.com", "vote": "up" | "down"}
限流
每 IP 20 次/分钟
示例
POST /api/feedback
{"domain": "google.com", "similarDomain": "youtube.com", "vote": "up"}
→ {"ok": true}