loklak.net搜索API参考指南：快速让应用接入开源搜索引擎-平芜编程栈

【免费下载链接】loklak.net

loklak.net

项目地址：https://gitcode.com/gh_mirrors/lo/loklak.net

Loklak Search（官方域名 loklak.net）是一个免费、开源的搜索引擎，本文是一份完整的搜索 API 参考指南：从健康检查、搜索请求、分页过滤到自建部署，5 分钟即可让你的应用接入 Loklak 搜索 API，并以 JSON / XML / Atom 三种格式获取搜索结果。

什么是 Loklak Search？为什么选择开源搜索 API？

Loklak Search 是一个去中心化的开源搜索引擎：爬虫与索引都可以部署在你自己的服务器上，API 接口与公共实例完全一致，无需注册账号、不产生费用、不采集个人数据。

✅核心优势

完全开源：可自行查看与托管，数据源由你掌控
去中心化：每个实例相互独立，不受单一平台策略约束
三种返回格式：JSON / XML / Atom，适配 Web 应用、脚本与订阅类场景

💡 关于本仓库：它是 loklak.net 的域名仓库。CNAME 为域名配置，index.html 会把浏览器 302 重定向到 loklak.org 的搜索页面。

快速开始：5 分钟跑通第一个搜索 API 请求

第 1 步：健康检查。对/api/health发起 GET 请求，返回OK表示服务可用：

curl "https://loklak.org/api/health"

第 2 步：发送第一个搜索请求。/api/search.json的q参数即搜索词：

curl "https://loklak.org/api/search.json?q=open%20source&pageSize=5"

第 3 步：解析响应。JSON 响应的核心结构如下：

{ "query": "open source", "docs": [ { "text": "文档摘要", "title": "结果标题", "url": "结果页面地址", "date": "2025-12-01T08:30:00Z", "category": "web", "language": "en", "location": "Berlin, Germany" } ], "response": { "numFound": 128, "start": 0, "time": 15 } }

字段	说明
`docs`	结果条目数组，每个命中一条
`docs[].text`/`title`/`url`	正文摘要、标题、来源链接
`docs[].date`/`location`/`language`	抓取时间、页面地理位置、语言
`response.numFound`	命中总数，用于计算分页
`response.time`	本次搜索耗时（毫秒）

三个主要搜索端点：JSON、XML、Atom

端点	格式	适用场景
`/api/search.json`	JSON	后端服务、移动端应用（最常用）
`/api/search.xml`	XML	传统系统、服务端渲染
`/api/search.atom`	Atom	RSS 式订阅、定期更新拉取

三者共用同一套q查询参数与过滤参数，只需按需选择返回格式。

搜索 API 参数参考表：分页、过滤与地理位置

参数	说明	示例
`q`	搜索词（必填）	`q=loklak`
`offset`	跳过前 N 条（用于分页）	`offset=20`
`pageSize`	每页条数，默认 20	`pageSize=50`
`language`	按语言过滤	`language=en`
`category`	按内容类别过滤	`category=web`
`before`/`after`	抓取时间范围	`after=2025-01-01`
`lat`/`lon`/`geo`	地理位置搜索，`geo`为半径（米）	`lat=39.9&lon=116.4&geo=5000`
`fields`	只返回指定字段（节省带宽）	`fields=title,url`

高级搜索语法：让结果更精准的 5 个技巧

在q参数中直接书写高级条件，可与上表的过滤参数叠加使用：

语法	作用	示例
`"精确短语"`	短语完全匹配	`q="open source search"`
`AND`/`OR`/`NOT`	布尔组合	`q=api AND json NOT xml`
`site:`	限定域名	`q=api site:loklak.org`
`*`通配符	前缀或模糊匹配	`q=searc*`
日期过滤	限定时间范围	`q=api after:2025-06-01`

辅助端点：自动补全、热门与状态检查

端点	说明
`/api/autocomplete.json`	输入框自动补全，`q`传入已输入前缀
`/api/trending.json`	热门搜索词（部分实例可能未提供）
`/api/status`	服务器与索引状态，适合做监控探针
`/api/about`	版本、运行时长等信息，便于诊断